什麼是 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 工作區的同一位使用者。
• 如果已啟用 啟用IP條件式存取原則驗證，則不支援 Azure DevOps。
• 如果工作區和 Git 存放庫位於兩個不同的地理區域，租用戶管理員必須啟用跨地區匯出。
• 如果您的組織設定 條件式存取，請確定 Power BI 服務 設定了相同的 條件，讓驗證如預期般運作。
• 提交大小限制為 125 MB。

GitHub 限制

• 僅支援 GitHub 的雲端版本。 不支持本地部署。
• GitHub 無法強制執行跨地區驗證。
• 一次提交的檔案總大小限制為 50 MB。 因此，如果您有多個項目需要提交，有時可能需要將它們分成幾次單獨的提交。 若要了解有關提交檔案的詳細資訊，請參閱疑難排解指南。

GitHub Enterprise 限制

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

• IP 允許清單

工作區限制

• 僅工作區管理員可以管理與 Git 存放庫的連線，例如連線、中斷連線或新增分支。
  連線之後，具有權限的任何人都可以在工作區中工作。

分支和資料夾限制

• 分支名稱長度上限為 244 個字元。
• 檔案名稱的完整路徑長度上限為 250 個字元。 名稱過長會導致失敗。
• 檔案大小上限為 25 MB。
• 資料夾結構最多可達到10個層級深。
• 使用 Git 整合部署報表/資料集之後，您無法從服務中將它們下載為 .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 換行符。 例如，如果您在桌面中開啟報表，請儲存項目檔 （.pbip），並使用 CRLF將其上傳至 Git。
• 若使用增強式重新整理 API 重新整理語意模型，系統會在每次重新整理之後產生 Git 差異。

相關內容

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