Azure Data Factory 中的全域參數

適用於：Azure Data Factory Azure Synapse Analytics

提示

試用 Microsoft Fabric 中的 Data Factory，這是適用於企業的全方位分析解決方案。 Microsoft Fabric 涵蓋從資料移動到資料科學、即時分析、商業智慧和報告的所有項目。 了解如何免費開始新的試用！

全域參數是資料處理站常數，任何運算式中的管線都可以使用。 當您有多個管線具有相同的參數名稱和值時，這些管線會很有用。 使用持續整合和部署程序 (CI/CD) 升級資料處理站時，您可以在每個環境中覆寫這些參數。

建立全域參數

若要建立全域參數，請移至 [管理] 區段的 [全域參數] 索引標籤。 選取 [新增] 以開啟建立側邊導覽。

在側邊導覽中，輸入名稱、選取資料類型，然後指定參數的值。

建立全域參數之後，您可以按一下參數的名稱開始編輯。 若要一次更改多個參數，請選取 [編輯全部]。

在管線中使用全域參數

全域參數可用於任何管線運算式。 如果管線參考另一個資源，例如資料集或資料流程，您可以透過該資源的參數傳遞全域參數值。 會以 pipeline().globalParameters.<parameterName> 的形式參考全域參數。

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

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

注意

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

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

• 在 ARM 範本中包含全域參數，(從 [管理中樞] - > [全域參數] - [包含在 ARM 範本中] - > [包含在 ARM])

• 透過 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: .....}"。 但是，您可以在參數名稱中使用「_」。

相關內容

• 瞭解 Azure Data Factory 的持續整合和部署程序
• 瞭解如何使用控制流程運算式語言