使用 Switch 活动在管道中有条件地设置执行的分支

Microsoft Fabric 中的 Switch 活动提供的功能与编程语言中 switch 语句提供的功能相同。 它计算一组与条件求值匹配的 case 相对应的活动。

先决条件

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

通过 UI 将查找活动添加到管道

若要在管道中使用 Switch 活动,请完成以下步骤:

创建活动

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

  2. 在管道的“活动”工具栏中搜索 Switch 活动,然后选择该活动,将其添加到管道画布中。 可能需要使用 + 按钮展开活动列表,因为可用的活动比工具栏通常容纳的活动要多。

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

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

    Screenshot showing the General settings tab of the Switch activity.

若要配置“常规”设置选项卡,请参阅常规”设置指导。

活动设置

选择“活动”选项卡,你将看到“默认”事例已经添加到事例列表中。

在 Expression 子句中,可提供要对其求值并与“事例”选项进行比较的表达式,并且该子句支持动态内容,让你能够使用项目中的参数、系统变量、函数和本地变量来与各种事例进行比较。

可使用“活动”选项卡上每个事例右侧的铅笔图标来配置当事例与表达式匹配时将执行的活动。 可使用“+ 添加事例”按钮,在任何其他事例均不与表达式结果匹配时执行的默认事例之外添加新事例。 还可直接在管道画布上的 Switch 活动界面上添加事例和活动,方法是选择 + 按钮来添加事例,或者选择列出的事例旁边的铅笔图标来为每个事例配置活动。

Screenshot showing the Lookup activity settings tab highlighting the tab, and where to choose a new connection.

配置事例活动

通过选择事例旁边的铅笔图标(在“活动”设置窗格中或直接在管道画布上的 Switch 活动界面上)编辑事例的活动时,你将看到事例的活动编辑器。 这类似于管道编辑器,但特定于所选的事例。 可添加任意数量的活动,就像使用管道一样,当所选事例与 Switch 活动的表达式匹配时,将执行这些活动。 在此示例中,复制活动已添加到默认事例中,并且只要没有其他事例与 Switch 活动中定义的表达式匹配,就会执行该复制活动。

Screenshot showing the case activities editor pane for the default case with a sample Copy activity added to it.

请注意事例的活动编辑器左上角的管道和事例。 配置事例的活动后,可在这里选择管道名称链接,再次导航回主管道编辑器。

进行保存,并运行或计划管道

切换到管道编辑器顶部的“开始”选项卡,然后选择“保存”按钮以保存管道。 选择“运行”来直接运行它,或者选择“计划”进行计划。 还可以在此处查看运行历史记录,或者配置其他设置。

Screenshot showing the Home tab in the pipeline editor with the tab name, Save, Run, and Schedule buttons highlighted.