1. 概述
1.1 版本
| FineDataLink 版本 | 功能变动 |
|---|---|
| 4.0.28 | 新增「Python脚本」节点 |
| 4.1.0 | 「脚本参数」下拉框中显示已配置参数 |
| 4.1.3 | 增加指定 Python 版本的功能 |
1.2 应用场景
用户的许多数据处理是通过 Python 脚本实现的，希望 FineDataLink 支持调用 Python 脚本。
1.3 功能简介
新增「Python脚本」节点，支持直接调用 Python 脚本。如下图所示：
2. 使用限制
1）Python 脚本若放在 Linux 或者 mac 时，脚本路径和参数值中禁止使用单引号'。
2）Python 脚本若放在 Windows 时，脚本路径和参数值中禁止使用双引号"。
3）若 FineDataLink 工程为 OPS 部署，脚本文件不建议放在 OPS 的挂载目录下，建议放在服务器的独立路径下，例如/data/xxx 。
否则，OPS 挂载目录在大版本升级的时候名称会变更，「Python脚本」将执行失败。
3. Python 脚本与 Python 算子区别
| 区别 | Python 脚本 | Python 算子 |
|---|---|---|
| 应用场景 | 在定时任务中调用已有的 Python 脚本 | 在数据开发过程中，对于一些复杂的数据处理（比如使用可视化算子或者 SparkSQL 较难实现的），需要在「数据转换」节点中使用 Python 脚本处理数据 |
| 使用位置 | 属于 步骤流 ，可与「数据转换」、「数据同步」等节点一起使用 | 属于 数据流 ，在「数据转换」节点中使用 |
| 使用过程 | 通过 SSH 数据连接，直接调用 Python 脚本：
| 配置 Python 环境后，在「Python算子」中编写 Python 代码实现
|
4. 示例
4.1 场景模拟
Python 脚本中保存着学生成绩信息：
给 Python 脚本输入学生姓名（本文示例中参数值为 John）参数，取出该学生成绩，将取出的数据输出到 test.txt 文件中，test.txt 为自动创建的文件，且与 Python 脚本在同一路径下。
示例数据：Python脚本.zip、name.xls
注：本文的远程服务器中，Python 版本为 2.7.5，用户若按照本文示例操作，可能需要修改脚本。
4.2 新建 SSH 数据连接
使用「Python脚本」节点执行 Python 脚本前，需要先配置 SSH 协议数据连接，远程连接目标服务器。如下图所示：
4.3 取出学生姓名并作为参数输出
1）取出学生姓名数据。如下图所示：
2）将取出的学生姓名数据作为参数输出。
Python 脚本中接收的参数名为 w，所以此处参数名也为 w ；取出第一列所有行的数据；默认值只是为了下游节点提前预览设置的，实际运行时不会用到这个默认值，直接从右侧的「参数预览」中复制即可。
如下图所示：
4.4 设置 Python 脚本节点
拖入「Python脚本」节点，设置要执行的 Python 脚本文件，添加 4.3 节设置的脚本参数。如下图所示：
各设置项说明如下表所示：
| 设置项 | 说明 |
|---|---|
| Python 命令 | 用于指定运行脚本时使用的命令，下拉框中可选择 Python、Python2、Python3 |
| SSH 连接 | 下拉所有可选的 SSH 连接 |
| 脚本路径 | 填写 SSH 目标端要执行的 Python 脚本完整路径：
|
| 脚本参数 | 1）指定传递给脚本的参数：
2）4.1.0 及之后版本，参数下拉框中显示已配置参数，分为任务内参数、全局参数：
|
| 命令超时配置 | 脚本开始执行到完全执行完毕的超时时间，默认选择无限制 执行X秒后超时中断，X值的范围：0~1000000 |
| 字符编码 | 指定输出字符编码，默认为UTF-8 下拉框内容：
|
4.5 运行结果
1）点击「保存并运行」按钮，任务执行成功后，如下图所示：
2）可看到 Python 脚本所在的路径下自动生成了 test.txt 文件，文件内容如下图所示：
上一篇：自动清理FineDataLink运行记录
