循环容器

1.1 版本

1.2 应用场景

用户有以下需求时：

• 使用「数据同步」节点 SQL 取数，数据量非常大的时候，想分段执行。

• 用 API 数据源取数，API 数据源的参数来自数据库内的一列字段内，API 参数每次只能读取一个参数，所以需要参数赋值支持参数值逐行输出，下方离线同步进行遍历。

可使用「循环容器」节点实现。

1.3 功能简介

「循环容器」节点可满足循环取数的场景。循环包括：

• 遍历循环：遍历完跳出循环执行。

• 条件循环：达到条件后跳出循环执行。

注：用户若想使用「循环容器」功能，需注册「循环容器」功能点。详情请参见：FineDataLink注册授权

2.1 循环容器节点说明

新增「循环容器」节点，界面如下图所示：

右键「循环容器」节点，界面如下图所示：

注：循环容器内不可拖入的节点类型：循环容器、调用任务

「循环容器」节点设置项介绍如下表所示：

2.2 参数赋值节点功能调整

1）调整对象：参数赋值的参数，输出多个值时，格式：{a,b,c,d,e}

以上调整，对老的功能并无影响，可以兼容老的使用逻辑。

2）增加参数赋值输出参数的值个数限制

对「参数赋值」中单个参数输出的字段值个数进行限制，限制最多不能超过 10000 个。

2.3 容器内参数

1）新增容器内置变量：

内置参数使用请参见：内置参数
2）容器内参数

容器内可以使用「参数赋值」，「参数赋值」输出的值形成容器内的参数：

• 容器内参数仅可在容器内使用，不可向容器外传递。

• 容器内参数优先级最高，优先级大于其他所有容器外参数和内置的参数。

2.4 日志介绍

任务中若包含循环容器节点，任务运行成功后，日志如下图所示：

日志具体介绍请参见：日志

「统计」Tab 页界面如下图所示：

示例：将 xiaoshou 表中的「编号」字段作为参数输出，逐条同步到新的表 xunhuan 中，「编号」为空停止输出。

3.1 数据准备

示例数据：xiaoshou.xls

表数据如下图所示：

3.2 新增参数赋值节点

1）新建一个 ETL 任务，将「参数赋值」节点拖入到设计界面。「参数赋值」节点具体设置如下图所示：

点击「数据预览」，如下图所示：

2）「输出参数」Tab 页设置如下图所示：

3.3 设置循环容器节点

3.3.1 新增循环容器节点和数据同步节点

新增「循环容器」节点，并将「数据同步」节点拖入到「循环容器」中，「循环容器」节点与「参数赋值」节点相连。如下图所示：

3.3.2 设置数据同步节点

1）点击「数据同步」节点。具体设置如下图所示：

SQL 语句为：select * from xiaoshou where 编号 =${aa}

2）点击「数据去向」Tab 。设置界面如下图所示：

3.3.3 设置循环容器节点

点击循环容器节点，循环方式选择「条件循环」，结束条件设置为aa字符串不包含null。如下图所示：

3.4 运行任务

点击右上角的「保存并运行」。如下图所示：

运行成功后，可看到数据库 etlwendy 中新增了一张表 xunhuan。如下图所示：