DataWorks为您提供遍历节点(for-each节点),您可以通过for-each节点来循环遍历赋值节点传递的结果集。同时您也可以重新编排for-each节点内部的业务流程。本文以一个具体示例,通过for-each节点2次循环遍历赋值节点输出结果,并在每次循环遍历时打印当前循环次数,为您介绍fo-each节点的逻辑原理与操作流程。
操作流程
使用遍历节点时,通常与赋值节点一起使用,操作流程如下所示。

- 设置节点依赖关系
for-each遍历节点需要依赖赋值节点。配置详情可参考文档:创建和配置业务流程。
- 赋值结果集
赋值节点自带的节点上下文输出参数outputs,需作为for-each遍历节点的节点上下文输入参数。配置详情可参考文档:配置赋值节点。
- 遍历节点的内部节点获取参数
根据业务需求自定义for-each遍历节点的内部业务流程,并在内部流程的节点中通过内置变量来获取所需参数值,运行循环遍历任务。内置变量的详情请参见内置变量,配置详情请参见配置for-each节点。
- 遍历节点不支持在DataStudio测试
请进入
运维中心操作,需要右键查看内部节点来查看详细执行过程。详情请参见
测试并查看测试结果。
说明 在运维中心执行任务时,选择
补数据功能,并同时选中执行赋值节点与遍历节点,单独运行遍历节点将无法获取到赋值节点传递的值。
创建和配置业务流程
您需要创建一个上游为赋值节点,下游为for-each节点的业务流程:
- 进入数据开发。
- 创建业务流程。
- 创建for-each节点。
- 鼠标悬停至
图标,单击。您也可以找到相应的业务流程,右键单击通用,选择。
- 在新建节点对话框中,输入节点名称,并选择目标文件夹。
- 单击提交。
- 创建赋值节点。
- 在业务流程的编辑页面,鼠标单击并拖拽至右侧的编辑页面。
- 在新建节点对话框中,输入节点名称,并选择目标文件夹(默认在当前业务流程目录下)。
- 单击提交。
- 通过拖拽连线,设置赋值节点为for-each节点的上游节点。
配置赋值节点
- 双击赋值节点名称,打开节点的编辑页面。
- 从请选择赋值语言列表中,选中SHELL。
- 在节点的编辑页面,输入以下语句。
- 单击节点编辑页面右侧的调度配置,在区域查看默认输出的outputs参数。
- 单击工具栏中的
图标,保存赋值节点。
- 提交赋值节点。
重要 您需要设置节点的重跑属性和依赖的上游节点,才可以提交节点。
- 单击工具栏中的
图标。
- 在提交新版本对话框中,输入备注。
- 单击确认。
如果您使用的是标准模式的工作空间,提交成功后,请单击右上角的
发布。具体操作请参见
发布任务。
配置for-each节点
- 双击打开for-each节点的编辑页面,默认有start、SQL和end三个节点。
- 删除SQL节点。
您可以根据自身需求,选择第2个节点为不同的类型:
- 如果您需要使用ODPS SQL节点,请跳过此步骤。
- 如果您需要使用其它类型的节点(本文以使用Shell节点为例),请先删除默认产生的SQL节点。
- 右键单击处于for-each节点中间的SQL节点,单击删除节点。
- 在删除对话框中,单击确定。
- 创建并编辑Shell节点。
您可以通过同样的方式,新建不同类型的节点。如果您使用的是默认的SQL节点,请跳过此步骤。
- 鼠标单击并拖拽至右侧的编辑页面。
- 在新建节点对话框中,输入节点名称。
- 单击提交。
- 在for-each节点的编辑页面,通过拖拽连线,设置Shell节点的上游为start节点,下游为end节点。
- 双击Shell节点,进入Shell节点的编辑页面。
- 输入以下代码。
echo ${dag.loopTimes} ----打印循环的次数。
说明
- for-each节点的start节点和end节点的逻辑是固定的,不可以进行编辑。
- Shell节点中的代码修改后请务必保存,提交时不会进行提示。如果未保存,最新的代码不能及时更新。
for-each节点支持以下四种环境变量:
- ${dag.foreach.current}:当前遍历到的数据行。
- ${dag.loopDataArray}:输入的数据集。
- ${dag.offset}:偏移量。
- ${dag.loopTimes}:当前循环次数,值为${dag.offset}+1。
变量详情请参见
内置变量和
内置变量取值案例。
- 配置for-each节点。
- 在for-each节点的编辑页面,单击右侧的调度配置。
- 在区域,单击默认参数名loopDataArray后的编辑。
- 从取值来源列表中,选择上游赋值节点的outputs参数。

说明 您在调度配置中添加上游赋值节点的依赖关系后,请手动添加取值来源。如果未添加取值来源,提交节点时会报错。
- 单击保存。
- 单击工具栏中的
图标,保存for-each节点。
- 提交for-each节点。
重要 您需要设置节点的重跑属性和依赖的上游节点,才可以提交节点。
- 单击工具栏中的
图标。
- 在提交对话框中,选中需要提交的节点,输入备注。
- 单击提交。
如果您使用的是标准模式的工作空间,提交成功后,请单击右上方的
发布。具体操作请参见
发布任务。
测试并查看测试结果
- 单击页面右上方的运维,进入运维中心。
- 在左侧导航栏,单击。
- 选中相应的节点,在右侧的DAG图中,右键单击赋值节点,选中。
- 刷新补数据实例页面,待补数据实例运行成功后,单击实例后的DAG图。
- 右键单击赋值节点,选中查看运行日志,确认赋值结果。
- 在补数据实例页面,右键单击遍历节点,选中查看内部节点。
- 在内部节点页面,单击左侧的第1次,并右键单击Shell节点,选中查看运行日志。

在运行日志页面,查看第1次循环时,Shell节点的日志。

- 以同样的方式,查看第2次循环时,Shell节点的日志。