什麼是 Microsoft Fabric Git 整合？

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

注意

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

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

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

與原始檔控制的整合位於工作區層級。 開發人員可以在單一程序中設定工作區內開發的項目版本，並完整查看其所有項目。 目前只支援幾個專案，但支援的專案清單正在增加。

• 請閱讀有關 Git 和 版本控制 的基本概念。

• 深入了解 Git 整合程序。

• 閱讀管理 Git 分支的最佳方式。

隱私權資訊

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

• Microsoft 隱私權聲明
• Azure DevOps Services 資料保護概觀
• GitHub 資料保護合約

支援的 Git 供應商

支援下列 Git 供應商：

• Azure Repos 中的 Git 與 Fabric 具有相同租用戶
• GitHub
• GitHub Enterprise

支援的項目

目前支援下列項目：

• 資料管線（預覽）
• 資料流 第二代（預覽）
• Eventhouse 和 KQL 資料庫（預覽）
• EventStream（預覽）
• Lakehouse（預覽）
• Notebooks
• 編頁報表（預覽）
• 反射（預覽）
• 報表（除了連線至 Azure Analysis Services、SQL Server Analysis Services中裝載之語意 模型的報告，或 Power BI Desktop 所導出的報表，這些報表相依於裝載於 MyWorkspace的語意模型 （預覽）
• 語意模型 （除了推送數據集、Analysis Services 實時連線、模型 v1） （預覽）
• Spark 作業定義（預覽）
• Spark 環境（預覽）
• SQL Database（預覽）
• 倉儲（預覽）

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

考量與限制

Git 整合一般限制

• Fabric 中的驗證方法必須至少與 Git 的驗證方法一樣嚴格。 例如，如果 Git 需要多重要素驗證，Fabric 也需要多重要素驗證。
• 目前不支援連線至 Analysis Services 的 Power BI 資料集。
• 已安裝範本應用程式的工作區無法連線到 Git。
• 不支援子模組。
• 主權雲端不支援。

Azure DevOps 限制

• Azure DevOps 帳戶必須註冊至正在使用 Fabric 工作區的相同使用者。
• 如果工作區和 Git 存放庫位於兩個不同的地理區域，租用戶管理員必須啟用跨地區匯出。
• 如果您的組織設定條件式存取，請確定Power BI服務已設定相同的條件，以便驗證如預期般運作。
• 認可大小限制為 125 MB。

GitHub 限制

• GitHub 無法強制執行跨地區驗證。
• 一次認可之檔案的總合併大小限制為 50 MB。 因此，如果您有數個項目要認可，有時可能需要將它們分成幾個單獨的認可。 若要了解有關認可檔案的詳細資訊，請參閱疑難排解指南。

GitHub Enterprise 限制

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

• IP 允許清單
• 私人網路
• 自訂網域

工作區限制

• 僅工作區管理員可以管理與 Git 存放庫的連線，例如連線、中斷連線或新增分支。
  連線之後，具有權限的任何人都可以在工作區中工作。
• 工作區資料夾結構不會反映在 Git 存放庫中。 資料夾中的工作區項目會匯出至根目錄。

分支和資料夾限制

• 分支名稱長度上限為 244 個字元。
• 檔案名稱的完整路徑長度上限為 250 個字元。 名稱較長則會失敗。
• 檔案大小上限為 25 MB。
• 使用 Git 整合部署報表/資料集之後，您無法從服務中將它們下載為 .pbix。
• 如果項目的顯示名稱，Git 資料夾會使用邏輯識別碼 （Guid） 作為類型之前的前置詞：
  • 字元數超過 256 個
  • 結尾為 . 或空格
  • 含有下列任何一個字元："/:<>\*?|

目錄名稱限制

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

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

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

分支限制

• 分支需要權限資料表中所列的權限。
• 必須有可用的容量才能執行此動作。
• 所有工作區和分支命名限制都會在分支至新的工作區時套用。
• 分支時會建立新的工作區，並且不會複製原始工作區中的設定。 調整設定或定義以確保新的工作區符合您組織的原則。
• 新的工作區中僅 Git 支援的項目可用。
• 相關的分支清單僅顯示您有權檢視的分支和工作區。
• 必須啟用 Git 整合。

同步和認可限制

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

相關內容

• 開始使用 Git 整合
• 了解 Git 整合程序