將 Azure Data Factory 全域參數轉換為 Fabric Data Factory 變數庫

Fabric 在工作空間中使用變數函式庫來定義管線及其他資料工廠與 Fabric 項目間的常數。 你可以透過幾個手動步驟,將 Azure Data Factory 的全域參數遷移到 Fabric 變數庫。

本指南將引導你了解整個流程:

  • 匯出 Azure Data Factory 全域參數
  • 在 Fabric 中建立工作區變數
  • 更新管線表達式
  • 驗證行為

了解 Fabric 變數函式庫

Fabric 的變數函式庫儲存了工作區層級的值,你可以跨管道和活動參照。 它支援字串、數字和布林值等類型,以及秘密的安全值。 你可以利用部署管線來對變數函式庫進行版本管理並將它們部署至不同的環境。

與 Azure Data Factory 的全域參數不同,Fabric 變數提供更嚴密的安全性、更易重用及更佳的治理控管。 你可以把它們套用到所有 Fabric 物品上。 欲了解更多資訊,請參閱 「開始使用變數函式庫」。

將 Azure Data Factory 全域參數移轉至 Fabric 變數程式庫

  1. 匯出 Azure Data Factory 全域參數。

    1. 在 Azure Data Factory Studio,切換到 Manage>Global Parameters。 記錄每個參數的名稱、類型和值。
    2. 對於大型遷移,請到 「管理>ARM 範本 」並匯出 ARM 範本,以程式化擷取參數。 你可以在 工廠 資料夾內的模板資料夾中找到它們,這些檔案的結尾是 ParametersForFactory 。
  2. 比較可用的類型。

    檢視你的 Azure Data Factory 全域參數類型(字串、整數、布爾等),並與 Fabric 變數庫類型做比較。 記錄任何可能需要在遷移過程中調整的類型差異。

  3. 在Fabric中建立變數庫。

    1. 在你的Fabric工作區中,選擇 + 新項目,然後搜尋並選擇 Variable library。
    2. 建立一個函式庫(例如,GlobalParams)。
    3. 打開你的新變數庫,選擇 +New 變數,並將每個 Azure Data Factory 的全域參數作為變數。

    欲了解更多關於建立變數函式庫的資訊,請參閱 「開始使用變數函式庫」。

  4. 更新遷移的流水線表達式。

    將全域參數參考 @globalParameters('ParamName') 更新為變數函式庫參考,如 @pipeline.libraryVariables.ParamName。

    更新所有活動表達式、連線字串、腳本參數、過濾邏輯和資料集屬性。 欲了解更多資訊,請參閱 變數函式庫與資料管線的整合。

  5. 驗證管線行為。

    執行驗證和測試來確認管線中的變數是否正確解析。 檢查連線、參數綁定和安全變數使用是否如預期般運作。

常見的移轉模式

以下是你在將全域參數轉換為變數函式庫時可能使用的一些遷移模式:

  • 直接對應 — Azure Data Factory 的簡單參數(例如區域或租用戶名稱)會與變數庫項目一一對應。

  • 環境專用函式庫 — 建立多個函式庫(Global-Dev、Global-Test、Global-Prod)。 部署管線可以根據環境綁定正確的函式庫。

  • 混合模型 — 將共享常數保留在變數函式庫中,但透過管線參數傳遞執行專屬資訊。

目前的限制

目前有幾項限制需要注意:

  • 內建 的升級體驗 和 PowerShell 升級工具 都不會自動升級全域參數。
  • 連結服務或管線中引用 @globalParameters() 的表達式不會自動重寫。
  • Fabric 連線(Azure Data Factory 連結服務的替代方案)不以相同方式支援參數表達式。 你需要手動重新撰寫連接定義中使用的任何動態參數。

最佳做法

請記住以下建議:

  • 遷移前先調整命名規則。
  • 避免過載工作區層級變數。 改用管線參數來設定執行時值。
  • 使用部署管線來管理環境特定的變數庫。
  • 記錄你的變數函式庫,讓團隊成員知道哪些管線依賴哪些變數。