共用方式為

什麼是 Microsoft Fabric Git 整合？

本文說明開發人員如何將 Git 版本控制與 Microsoft Fabric 應用程式生命週期管理 （ALM） 工具整合。

注意

Git 整合的某些項目處於預覽狀態。 如需詳細資訊，請參閱 支援的項目清單。

Microsoft Fabric 中的 Git 整合可讓開發人員將其開發程序、工具和最佳做法直接整合到 Fabric 平台中。 它可讓在 Fabric 中開發的開發人員：

  • 備份及管理其工作版本
  • 視需要還原至先前的階段
  • 與其他人共同作業，或使用 Git 分支單獨工作
  • 套用熟悉的原始檔控制工具的功能來管理 Fabric 項目

與版本控制的整合屬於工作區層級。 開發人員可以在單一程序中設定工作區內開發的項目版本，並完整查看其所有項目。 工作區結構，包括 子資料夾，會保留在 Git 存放庫中。

請參閱 支援的項目清單。

Git 整合的網路安全性

Microsoft Fabric 中的工作區層級安全性可讓系統管理員設定個別工作區的輸入和輸出保護，以提供對資料存取和網路連線的細微控制。 這些控制可確保敏感資料保留在受信任的網路邊界內，並與 Git 整合等 CI/CD 工具整合。 如需詳細資訊，請參閱 持續整合/持續部署的網路安全性

隱私權資訊

啟用 Git 整合之前，確認您已檢閱下列隱私權聲明：

支援的 Git 供應商

支援下列 Git 供應商：

支援的項目

下列項目目前支援 Git 整合：

若工作區或 Git 目錄具有不支援的項目，其仍可連線但會忽略不支援的項目。 它們不會儲存或同步處理，但也不會刪除。 這些項目會出現在版本控制面板中，但您無法提交或更新它們。

考量與限制

一般 Git 整合限制

  • Fabric 中的 驗證方法 至少必須和 Git 的驗證方法一樣強。 例如，如果 Git 需要多重要素驗證，Fabric 也需要多重要素驗證。
  • 目前不支援連線至 Analysis Services 的 Power BI 資料集。
  • 如果您在某個工件中使用工作區身分識別並將其提交至 Git，則只能在連線至相同身分識別的工作區中更新它（返回到一個網狀架構的工作區）。 請小心，因為這也會影響分支輸出之類的功能。
  • 不支援子模組。
  • 不支援主權雲端服務。
  • 如果你的工作區有數百個項目，可以考慮將其拆分成較小的工件集合。 每組應該放置在獨立的工作空間中，並鏈接到不同的 Git 分支，或連接到在不同資料夾中組織的單一分支。
  • 如果已啟用 啟用IP條件式存取原則驗證 ，則不支援 Azure DevOps。
  • 如果工作區和 Git 存放庫位於兩個不同的地理區域，租用戶系統管理員必須啟用 跨地理位置匯出。
  • 如果您的組織已設定 條件式存取，請確定 Power BI服務 已設定相同的 條件 ，以便驗證如預期般運作。
  • 以下是適用的提交大小限制：
    • 使用 Azure DevOps 連接器搭配 Service Principal，使用 25 MB。
    • 125 MB，使用預設的單一登入（SSO）Microsoft Entra ID 帳號及 Azure DevOps 連接器，並使用 User Principal。

GitHub Enterprise 限制

不支援某些 GitHub Enterprise 版本和設定。 例如：

  • 具有數據駐留的 GitHub Enterprise Cloud (ghe.com)
  • 即使該伺服器公開可存取，GitHub Enterprise Server 使用自定義網域依然不受支援。
  • 架設於私人網路上的 Github Enterprise Server
  • IP 允許清單

Azure DevOps 到 GitHub Enterprise 遷移考量

如果您的團隊使用 Fabric Git 整合，並正在評估從 Azure DevOps 遷移到 GitHub Enterprise，建議執行驗證測試以確保 Git 整合功能不受影響。 Fabric Git 整合依賴底層的 Git 提供者 API，這些 API 在 Azure DevOps 與 GitHub Enterprise 之間的能力與限制有所不同，如上所述。

工作區限制

  • 只有工作區管理員可以管理 Git 存放庫 的連線，例如連線、中斷連線或新增分支。
    連線之後，具有 許可權 的任何人都可以在工作區中工作。
  • 已安裝範本應用程式的工作區無法連線到 Git。
  • MyWorkspace 無法連線到 Git 提供者。

分支和資料夾限制

  • 分支名稱長度上限為 244 個字元。
  • 檔案名稱的完整路徑長度上限為 250 個字元。 名稱過長會導致失敗。
  • 檔案大小上限為 25 MB。
  • 資料夾結構最多可達到10個層級深。
  • 不建議在使用 Git 整合部署報表/數據集後，從服務下載為 .pbix ，因為結果不可靠。 我們建議使用PowerBI Desktop將報表/數據集下載為 .pbix。
  • 如果項目的顯示名稱具有下列任何特性，Git 資料夾會重新命名為邏輯識別碼 （Guid） 並輸入：
    • 字元數超過 256 個
    • 結尾是 。 或空格
    • 包含任何禁止字元，如目錄名稱限制中所述
  • 當您將具有資料夾的工作區連接到 Git 時，如果資料夾結構有所不同，則必須將變更提交至 Git 存放庫。

目錄名稱限制

  • 線上至 Git 存放庫的目錄名稱具有下列命名限制：

    • 目錄名稱不能以空格或製表符開始或結尾。
    • 目錄名稱不能包含下列任何字元：“/：<>\*|

  • 專案資料夾（包含專案檔案的資料夾）不能包含下列任何字元： “：<>\*？|。 如果您將資料夾重新命名為包含這些字符之一的名稱，Git 將無法連接或同步處理工作區，並會發生錯誤。

分支延展限制

  • 分支操作需要許可權表中所列的許可權。
  • 必須有可用的容量才能執行此動作。
  • 所有 工作區 和 分支命名限制 都會在分支至新的工作區時套用。
  • 新的工作區中僅提供 Git 支援的專案 。
  • 相關的分支清單僅顯示您有權檢視的分支和工作區。
  • 必須啟用 Git 整合。
  • 當建立分支時，會建立新的分支，而且不會複製原始分支中的設定。 調整任何設定或定義，以確保新符合貴組織的原則。
  • 擴展到現有工作空間時：
    • 目標工作區必須支援 Git 連線。
    • 用戶必須是目標工作區的管理員。
    • 目標工作區必須具有容量。
    • 工作區不能有範本應用程式。
  • 請注意，當您分支至工作區時，未儲存至 Git 的任何項目都會遺失。 建議您在分支之前 提交 任何想要保留的項目。

同步和提交限制

  • 在任何時間，你只能將資料同步至一個方向。 您無法同時進行提交和更新操作。
  • 不支援敏感度標籤，並且可能會停用匯出具有敏感度標籤的項目。 若要提交沒有敏感度標籤的專案，請向系統管理員尋求協助。
  • 適用於 有限的項目。 資料夾中不受支援的項目會略過。
  • 不允許複製名稱。 即使 Power BI 允許重複名稱，更新、認可或復原動作也會失敗。
  • 不支援 B2B（企業對企業）。
  • 衝突解決 是在 Git 中部分完成的。
  • 在 認可 Git 程式期間，Fabric 服務會刪除不屬於專案定義之 專案資料夾內的 檔案。 不會刪除不在項目資料夾中的非相關檔案。
  • 提交變更之後，您可能會注意到項目出現了一些您未作出的非預期變更。 這些變更在語意上無關緊要，且可能存在多個原因。 例如：
    • 手動變更項目定義檔案。 這些變更有效，但可能不同於透過編輯器完成的變更。 例如，如果您在 Git 中重新命名語意模型的欄，並將這項變更匯入至工作區，下次您在認可對語意模型的變更時，bim 檔案將會註冊為已變更，並將修改的欄推送至陣列的最後面 columns 。 這是因為產生 bim 檔案的 AS 引擎會將重新命名的數據行推送至陣列結尾。 這項變更不會影響項目的運作方式。
    • 提交使用 CRLF 換行符的檔案。 服務使用 LF （換行字元） 換行符。 如果您在 Git 存放庫中有 具有 CRLF 換行符的項目文件，當您從服務提交這些文件時，這些文件會轉換為 LF。 例如，如果您在桌面中開啟報表，請使用CRLF儲存項目檔 （.pbip） 並將其上傳至 Git。
  • 使用增強式重新整理 API 重新整理語意模型，會在每次重新整理之後產生 Git 差異。

相關內容

  • Last updated on