Azure 数据工厂和 Azure Synapse Analytics 中的管道参数和变量
适用于：
Azure 数据工厂 Azure Synapse Analytics
提示
试用 Microsoft Fabric 中的数据工厂，这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用！
本文帮助你了解 Azure 数据工厂和 Azure Synapse Analytics 中的管道参数和变量之间的差异，以及如何使用它们来控制管道行为。
管道参数
参数是在管道级别定义的，在管道运行期间不可修改。 管道参数可用于控制管道的行为及其活动，例如通过传入数据集的连接详细信息或要处理的文件的路径。
如何定义管道参数
若要定义管道参数，请执行以下步骤：
- 单击该管道以查看其配置选项卡。
- 选择“参数”选项卡，然后单击“+ 新建”按钮以定义新参数。
- 输入参数的名称和说明，然后从下拉菜单中选择其数据类型。 数据类型可以是 String、Int、Float、Bool、Array、Object 或 SecureString。
- （可选）还可为参数分配默认值。
定义管道参数后，可以在管道运行期间使用管道活动中的 @pipeline().parameters.<parameter name> 表达式访问该参数的值。 例如，如果你定义了一个名为 account_name、类型为 String 的参数，可以使用表达式 @pipeline().parameters.account_name 在活动中访问其值。
在每个管道运行之前，可以在右侧面板中为参数分配新值，否则管道将使用默认值或以前定义的值。
管道变量
管道变量是可以在管道运行期间设置和修改的值。 与管道参数不同，可以使用设置变量活动在管道内部设置和修改管道变量，而前者是在管道级别定义的，在管道运行期间不可更改。
管道变量可用于在管道运行期间存储和操作数据，例如通过存储计算结果或进程的当前状态。
注意
变量目前在管道级别范围内。 这意味着变量不是线程安全的，如果从并行迭代活动（如 foreach 循环）中访问变量，尤其是当值也在该 foreach 活动中被修改时，可能会导致意外的、你不希望其出现的行为。
若要定义管道变量，请执行以下步骤：
单击该管道以查看其配置选项卡。
选择“变量”选项卡，然后单击“+ 新建”按钮以定义新变量。
输入变量的名称和说明，然后从下拉菜单中选择其数据类型。 数据类型可以是 String、Bool 或 Array。
（可选）还可为变量分配默认值。 在管道运行开始时，此值将用作变量的初始值。
定义管道变量后，可以在管道运行期间使用管道活动中的 @variables('<variable name>') 表达式访问该变量的值。 例如，如果你定义了一个名为 flag 的、类型为 Array 的变量，可以使用表达式 @variables('flag') 在活动中访问其值。 还可以使用“设置变量”活动在管道中修改变量的值。
相关内容
参阅以下教程，了解创建包含以下活动的管道的分步说明：