参数输出

1 概述

1.1 版本

1.2 应用场景

【参数输出】组件是实现智能化、参数化数据流程的基石，常见应用场景包括：
场景一：为条件判断提供动态值

• 场景：在任务开始时，首先查询数据库获取“最新的业务日期”（如 MAX(biz_date)），然后将这个日期作为参数输出。后续的“条件SQL”或“数据过滤”组件可以引用这个参数，来决定处理哪一天的数据，从而实现增量同步。
• 组件作用：“参数输出”将查询到的动态值（如 2024-01-15）赋给参数（如 biz_date），后续节点通过 ${biz_date}来引用它。

场景二：循环任务的列表驱动

• 场景：需要按城市、产品类别等维度分别运行同一个数据处理流程。可以先用一个“参数输出”组件查询出所有不重复的城市列表。
• 组件作用：将城市列表输出为一个数组参数（如 city_list = [‘北京’， ‘上海’， ‘广州’]）。然后将此参数传递给【循环容器】组件，循环容器组件会遍历每个城市值，并每次将当前城市值作为参数传递给下游的数据处理子流程。

1.3 功能简介

【参数输出】组件是数据开发平台中用于数据传递和流程控制的关键组件。它的核心功能是从上游数据流（如“DB输入”组件查询出的数据）中提取特定值，并将其赋值给一个用户自定义的任务参数。这个被赋值的参数可以在后续的任务节点或整个任务流中被使用，从而实现动态传值、流程判断和上下文信息传递。

2 功能说明

主要就是配置输出参数：
可选择任务参数，将上游节点中处理的[数据来源]中获取的数据表的行列数据赋值给该参数。如下图所示：

具体功能说明如下：
1）参数
输出的参数需要先通过工具栏中的“参数”定义任务参数，如下图：

全局定义好之后，此处选择对应的任务参数即可。

注：同一个参数输出节点中多个输出参数不支持选择同一个任务参数。

2)值来源
指定上游节点中获取的行列数据作为参数的实际值，支持指定某一行数据、某一列数据或某个单元格值三种。
比如，选择第三列“name_”的所有数据，配置如下：

这里的值是用于任务运行时使用的参数值。

注：【输出参数】中单个参数输出的字段值个数限制最多不能超过10000个。如果参数的输出结果超过限制，则该节点运行会失败。

3）调试值
调试值仅用于任务调试过程中进行数据预览时使用，即任务调试时组件会优先使用您在这里输入的调试值，而不是真正从上游数据源读取值。这可以方便您快速测试下游逻辑，而无需等待漫长的数据查询。

注：调试值允许输入多个值，多个值之间使用“逗号”分隔。

3 参数使用

1、任务调试时，输出参数的参数值使用优先级：
1）【参数输出】中设置的参数调试值>当前任务中设置的参数默认值。
2）当同一个任务中添加了多个【参数输出】节点，若不同节点使用了相同的参数，该参数被下游节点引用时，距离节点越近的「参数输出」参数优先级越高。
2、支持跨节点传递参数
【参数输出】下游所有的节点都可以使用输出的参数，但是不可跨分支被其他节点使用。
3、参数引用的写法
若参数值为整型、双精度型、布尔型，直接用${参数名}的方式引用参数；
若参数值为字符类型、日期类型，需要加上单引号引用参数 :’${参数名}’。