Shell脚本

1.1 版本说明

1.2 应用场景

用户希望在 FineDataLink 中调用 Kettle 任务、调用 Python 计算任务、Java 程序/ Spark 程序，或者进行数据库备份还原等操作。

1.3 功能简介

「Shell 脚本」节点通过连接指定服务器，调用服务器上的 Shell 脚本执行任务，对接外部的独立数据处理过程。

例如 SVN 更新、文件运维清理、调用 Kettle 任务、调用 Python 计算任务、调用 Spark 计算任务、执行数据库备份还原等。

同时「Shell 脚本」节点支持在脚本中使用 FineDataLink 中设置的  参数

demo 任务详情请参见：https://demo.finedatalink.com/  「SHELL 脚本-副本」

1.4  使用限制

仅支持执行 Linux 系统下后缀名为 .sh的脚本文。

3.1 配置SSH协议数据连接

由于需要在目标服务器执行指定 Shell 脚本，因此需要首先通过 SSH 远程连接至目标服务器。

配置 SSH 数据连接步骤请参见：配置SSH协议数据连接

3.2 准备 shell 脚本

例如某 Shell 脚本如下图所示：

其中 $0：指所写的 Shell 脚本本身的名字；$1、$2、$3分别为写入的三个参数（三个参数将在 FineDataLink 中进行赋值）。

执行脚本后，最终会输出三个参数值：参数一：存储在 fine_apple 数据表中的指定位置数据（苹果）；参数二：当前任务运行时间；参数三：手动赋值 b3，如下图所示：

3.3 设置参数

由于第一个参数 $1存储在数据表中，我们使用参数赋值取出。

首先新建「参数赋值」节点，从数据表中取出需要使用的数据（例如这里取出苹果）作为参数，如下图所示：

fine_apple 数据表如下：

第二个和第三个参数 $2、$3 直接使用参数列表，如下图所示：

3.4 设置 Shell 脚本

新建 Shell 脚本，将参数赋值节点和脚本连接，选择需要远程执行任务的目标服务器 SSH 连接位置，写入脚本路径，然后设置脚本参数，点击添加参数，将 3.3 节设置参数 b1、b2、b3 添加至脚本参数中，如下图所示：

注：如果 Shell 脚本在循环容器中使用到其遍历使用的参数时，取到的参数值为遍历过程中的值。

3.5 执行任务

点击「运行」，即可执行任务，如下图所示：

如果需要更详细的日志输出，可将日志等级调整为INFO：日志等级设置，详细日志如下图所示：

执行任务后，即可在脚本设置的输出文件中看到输出结果，即输出了三个参数，如下图所示：

3.6 如何判断脚本执行成功

详情参见：Shell 脚本执行结果说明

3.7 后续操作

若 Shell 脚本需要周期性调度执行，需要设置任务调度，详情请参见：调度计划

在 Shell 脚本中，输出信息可以通过以下三种方式进行：

• echo 命令：用于输出信息到标准输出。

• printf 命令：类似于其他编程语言中的打印函数，可以格式化输出文本。

• echo 命令结合重定向：将输出结果重定向到文件或其他程序。

以下是每种方式的示例代码：

使用 echo 输出文本：

echo "Hello, World!"

使用 printf 输出格式化文本：

printf "Name: %s\nAge: %d\n" "Alice" 30

使用重定向将输出保存到文件：

echo "This will be saved to a file" > output.txt

前两种输出方式都会直接在日志中输出，如下图所示：

第三种重定向输出会直接输出到文件中，不会在日志中显示。