你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Azure 数据工厂中的全局参数

适用于: Azure 数据工厂 Azure Synapse Analytics

提示

试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用

全局参数是整个数据工厂的常量,可以由任何表达式中的管道使用。 当多个管道具有相同的参数名称和值时,这些全局参数会很有用。 使用持续集成和部署过程 (CI/CD) 提升数据工厂时,可以在每个环境中替代这些参数。

创建全局参数

若要创建全局参数,请转到“管理” 部分中的“全局参数”选项卡。 选择“新建”以打开“创建”侧导航栏。

Screenshot that highlights the New button you select to create global parameters.

在侧导航栏中,输入名称,选择数据类型,并指定参数的值。

Screenshot that shows where you add the name, data type, and value for the new global parameter.

创建全局参数后,可以通过单击参数的名称对其进行编辑。 若要同时更改多个参数,请选择“全部编辑”。

Create global parameters

在管道中使用全局参数

全局参数可用于任何管道表达式。 如果管道引用其他资源(如数据集或数据流),则可以通过该资源的参数向下传递全局参数值。 全局参数以 pipeline().globalParameters.<parameterName> 形式进行引用。

Using global parameters

CI/CD 中的全局参数

建议在 CI/CD 期间在 ARM 模板中包括全局参数。 在 ARM 模板中包括全局参数的新机制(“管理中心”->“ARM 模板”->“在 ARM 模板中包括全局参数”,如下所示)不会像过去那样与工厂级别设置冲突,也不会替代工厂级别设置,因此不需要其他 PowerShell 就可以在 CI/CD 期间进行全局参数部署。

Screenshot of 'Include in ARM template'.

注意

我们已将用于包括全局参数的 UI 体验从“全局参数”部分移到“管理中心”中的“ARM 模板”部分。 如果已在使用旧机制(“管理中心”->“全局参数”->“包含在 ARM 模板中”),则可以继续操作。 我们将继续支持它。

如果使用在持续集成和部署解决方案中集成全局参数的较旧流,它会继续工作:

  • 将全局参数包含在 ARM 模板中(“管理中心”->“全局参数”->“包含在 ARM 模板中”)Screenshot of deprecated 'Include in ARM template'.

  • 通过 PowerShell 脚本部署全局参数

强烈建议使用将全局参数包含在 ARM 模板中的新机制(“管理中心”->“ARM 模板”->“将全局参数包含在 ARM 模板中”),因为它使 CICD 与全局参数的配合使用更加简单且更易于管理得多。

注意

只能在“Git 模式”下使用“将全局参数包含在 ARM 模板中”配置。 当前它在“实时模式”或“数据工厂”模式下处于禁用状态。

警告

不能在参数名称中使用“-”。 否则将收到错误代码 "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}"。 但可以在参数名称中使用“_”。