通过 ForEach 活动转换数据

ForEach 活动在 Microsoft Fabric 管道中定义重复的控制流。 此活动用于循环访问集合,并在循环中执行指定的活动。 此活动的循环实现类似于采用编程语言的 Foreach 循环结构。

将 ForEach 活动添加到管道

本部分介绍如何在管道中使用 ForEach 活动。

先决条件

如果要开始,必须满足以下先决条件:

创建活动

  1. 在工作区中创建新管道。

  2. 在管道“活动”窗格中搜索“ForEach”,然后将其添加到管道画布上。 如果最初未找到,请使用活动工具栏右侧的箭头向右滚动寻找。

    Screenshot of the Fabric UI with the Activities pane and ForEach activity highlighted.

  3. 在画布上选择此新的 ForEach 活动(如果尚未选择)。

    Screenshot showing the General settings tab of the ForEach activity.

  4. 在画布底部的“常规”选项卡中,在 Name 属性中输入活动的名称。

  5. (可选)也可以输入说明。

ForEach 设置

选择“设置”选项卡,从中指定批处理中项的处理是按顺序(还是并行)。 还可以使用 Batch 计数指定要同时处理的最大项数。 最后,必须指定逗号分隔的列表,这些项可以参数化或包含动态内容。 将几个项添加到“”列表,如示例所示。

Screenshot showing the ForEach settings tab with several items added to the Items list.

ForEach 活动

你还将在 ForEach“活动”窗格中定义要对列表中的每个项执行的活动。

Screenshot showing the ForEach activities pane.

选择 + 按钮,将新活动添加到窗格。 将显示要选择的活动列表。 可以将多个活动添加到 ForEach 活动,每个活动会在“”列表中的每个项上运行。 无论在 ForEach 设置中是否选择了“按顺序”选项,ForEach 活动窗格中的每个子活动都会按顺序对每个项运行。 但是,如果未选择“按顺序”,则并行处理多个项,其中每个项按顺序通过指定的子活动列表运行。

Screenshot showing a ForEach activity with multiple child activities specified, and the + button highlighted showing a list of child activities to choose from when adding new activities to the pane.

引用活动中的项

在 ForEach“活动”窗格中选择一个子活动,然后切换到其“设置”选项卡。在此示例中,选择了“存储过程”活动。 像通常选择连接和存储过程那样填充活动的设置。 可以使用 @item() 迭代器引用支持动态内容的活动中任意位置正在处理的当前项。 @item () 用作传递给存储过程的 FruitName 参数的值。

Screenshot showing a stored procedure child activity with a parameter using the current @item() from the ForEach items list for its value.