Git 整合簡介 (預覽版)

  • 發行項

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

重要

這項功能目前為預覽版。

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

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

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

隱私權資訊

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

支援的 Git 供應商

支援下列 Git 供應商：

支援的項目

目前支援下列項目：

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

考量與限制

Git 整合一般限制

  • Fabric 中的驗證方法必須至少與 Git 的驗證方法一樣嚴格。 例如，如果 Git 需要多重要素驗證，Fabric 也需要多重要素驗證。
  • 目前不支援連線至 Analysis Services 的 Power BI 資料集。
  • 主權雲端不支援。
  • Azure DevOps 帳戶必須註冊至正在使用 Fabric 工作區的相同使用者。
  • 如果工作區和 Git 存放庫位於兩個不同的地理區域，租用戶管理員必須啟用跨地區匯出。
  • 認可大小限制為 125 MB。

GitHub Enterprise 限制

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

  • IP 允許清單
  • 私人網路

工作區限制

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

分支和資料夾限制

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

分支限制

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

同步和認可限制

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

相關內容