你当前正在访问 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 期间进行全局参数部署。

“包含在 ARM 模板中”的屏幕截图。

注意

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

下载的 ARM 模板中的“参数”文件夹包含用于定义 ARM 模板中使用的参数的 JSON 文件。 每个文件与特定的全局参数相对应。

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

  • 将全局参数包含在 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: .....}"。 但可以在参数名称中使用“_”。