Azure Data Factory 中的全域參數

適用於:Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory,這是適用於企業的全方位分析解決方案。 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

持續整合與持續傳遞中的全域參數

建議您在持續整合與持續傳遞期間在 ARM 範本中包含全域參數。 在 ARM 範本中包含全域參數的新機制 (從 [管理中樞] - [ARM 範本] >> - [在 ARM 範本中包含全域參數]),如下所示,將不會衝突/覆寫先前用來執行的處理站層級設定,因此不需要額外的 PowerShell 在 持續整合與持續傳遞期間進行全域參數部署。

Screenshot of 'Include in ARM template'.

注意

我們已將包含全域參數的 UI 體驗從 [全域參數] 區段移至管理中樞的 [ARM 範本] 區段。 如果您已經使用來自 [管理中樞] - [全域參數] - >> [包含在 ARM 範本內] 的較舊機制,您可以繼續。 我們將會繼續對其加以支援。

如果您使用在持續整合和部署解決方案中整合全域參數的較舊流程,其將會繼續運作:

  • 在 ARM 範本中包含全域參數,(從 [管理中樞] - > [全域參數] - [包含在 ARM 範本中] - > [包含在 ARM]) Screenshot of deprecated 'Include in ARM template'.

  • 透過 PowerShell 指令碼部署全域參數

強烈建議使用新的機制,在 ARM 範本中包含全域參數,(從 [管理中樞]- [ARM 範本] >> - [在 ARM 範本中包含全域參數]) ,因為其使 CICD 具有全域參數更為簡單且更容易管理。

注意

[在 ARM 範本中包含全域參數] 的設定僅適用於[Git 模式]。 目前已在「即時模式」或「Data Factory」模式中停用。

警告

您無法在參數名稱中使用「-」。 您會收到錯誤碼 "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}"。 但是,您可以在參數名稱中使用「_」。