上下文参数，是指在参数配置中，通过配置输入参数、输出参数两个特殊参数，实现数据在上游和下游节点之间自动传递的效果。

使用限制：

• 输出参数：只支持SQL、Python、Shell三个任务节点配置输出参数
• 传递层级：只支持一层的传递，即只支持上游传递给其所依赖的下游。
• 传值大小：最大支持2MB的数据传递。

使用方式

• 上游节点（提供方）：负责生成一个值并将其作为输出参数。

  • 配置赋值输出参数：系统将节点代码（如 SELECT * from table_A;）的最后一行查询结果，捕获并赋值给一个内置的输出参数 outputs，然后将这个参数的值传递给下游节点。参数值取决于代码的运行结果。

• 下游节点（使用方）：接收并使用上游节点提供的值。

  • 建立调度依赖：配置对上游节点的调度依赖。
  • 配置输入参数：在下游节点的参数配置区域，添加输入参数，并将其取值来源设置为上游节点的输出参数。
  • 在代码中引用：在下游节点的代码中，通过 ${输入参数名} 的格式引用接收到的值。例如，若上游节点传递了值 table_A，下游代码中的 SELECT '${输入参数名}'; 在运行时，就会将上游输出的结果打印出来。

配置说明

配置输出参数

预览

如果希望将当前节点的结果传递给下游，则可以按照如下步骤操作：

1. 点击该节点，参数>输出参数
2. 点击「新建」，会自动填充内置参数$[output]。

配置输入参数

配置输入参数

打开下游节点的编辑页面，点击参数>输入参数 ，点击新建。

配置输入参数。

• 参数名称：在脚本中引用的参数名称。

• 参数取值：从上游节点的输出参数中选择一个作为本参数的取值来源。

  • 上游依赖：即当前配置好的上游任务中，选择其中有输出参数的作为输入参数的取值。
  • 其他：若想添加其他输出参数的任务，则可通过「其他」选择，选定后，会默认将对该任务的依赖配置上。

预览

引用参数

在下游节点的代码中，通过 ${输入参数名} 的格式引用参数。

以下为 SQL节点引用输入参数 param 的示例：

select "${param}"

若上游节点使用赋值结果传递给下游，参数值通常为二维数组或通过逗号分隔的一维数组，可参考以下方式获取数组内的值：

• 若上游为SQL节点（二维数组）：

  • 行：${param[i]}。
  • 单元格： ${param[i][j]}。
  • 若上游为Python/Shell （一维数组）：行：${param[i]}。