你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Azure 数据工厂中的全局参数
适用于: Azure 数据工厂 Azure Synapse Analytics
提示
试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用!
全局参数是整个数据工厂的常量,可以由任何表达式中的管道使用。 当多个管道具有相同的参数名称和值时,这些全局参数会很有用。 使用持续集成和部署过程 (CI/CD) 提升数据工厂时,可以在每个环境中替代这些参数。
创建全局参数
若要创建全局参数,请转到“管理” 部分中的“全局参数”选项卡。 选择“新建”以打开“创建”侧导航栏。
在侧导航栏中,输入名称,选择数据类型,并指定参数的值。
创建全局参数后,可以通过单击参数的名称对其进行编辑。 若要同时更改多个参数,请选择“全部编辑”。
在管道中使用全局参数
全局参数可用于任何管道表达式。 如果管道引用其他资源(如数据集或数据流),则可以通过该资源的参数向下传递全局参数值。 全局参数以 pipeline().globalParameters.<parameterName>
形式进行引用。
CI/CD 中的全局参数
建议在 CI/CD 期间在 ARM 模板中包括全局参数。 在 ARM 模板中包括全局参数的新机制(“管理中心”->“ARM 模板”->“在 ARM 模板中包括全局参数”,如下所示)不会像过去那样与工厂级别设置冲突,也不会替代工厂级别设置,因此不需要其他 PowerShell 就可以在 CI/CD 期间进行全局参数部署。
注意
我们已将用于包括全局参数的 UI 体验从“全局参数”部分移到“管理中心”中的“ARM 模板”部分。 如果已在使用旧机制(“管理中心”->“全局参数”->“包含在 ARM 模板中”),则可以继续操作。 我们将继续支持它。
如果使用在持续集成和部署解决方案中集成全局参数的较旧流,它会继续工作:
将全局参数包含在 ARM 模板中(“管理中心”->“全局参数”->“包含在 ARM 模板中”)
通过 PowerShell 脚本部署全局参数
强烈建议使用将全局参数包含在 ARM 模板中的新机制(“管理中心”->“ARM 模板”->“将全局参数包含在 ARM 模板中”),因为它使 CICD 与全局参数的配合使用更加简单且更易于管理得多。
注意
只能在“Git 模式”下使用“将全局参数包含在 ARM 模板中”配置。 当前它在“实时模式”或“数据工厂”模式下处于禁用状态。
警告
不能在参数名称中使用“-”。 否则将收到错误代码 "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}"。 但可以在参数名称中使用“_”。