Git 整合簡介 (預覽)
本文說明開發人員如何整合 Git 版本控制與 Fabric 應用程式生命週期管理 (ALM) 工具。
Microsoft Fabric 中的 Git 整合可讓開發人員將其開發程式、工具和最佳做法直接整合到 Fabric 平臺。 它可讓在 Fabric 中開發的開發人員:
- 備份和版本其工作
- 視需要還原至先前的階段
- 使用 Git 分支與其他人共同作業或單獨工作
- 套用熟悉的原始檔控制工具來管理網狀架構專案的功能
與原始檔控制的整合位於工作區層級。 開發人員可以在單一程式中建立工作區內開發的專案版本,並完整查看其所有專案。 目前,在預覽版中,僅支援少數專案,但支援的專案清單正在增加。
隱私權資訊
啟用 Git 整合之前,請確定您檢閱下列隱私聲明:
支援的 Git 提供者
支援下列 Git 提供者:
- Azure Repos 中的 Git 與 Fabric 租 使用者相同
- GitHub
- GitHub Enterprise
支援的專案
目前支援下列專案:
- 數據管線
- Lakehouse
- Notebooks
- 編頁報表
- 報表(除了連線至 Azure Analysis Services 中裝載的語意模型、SQL Server Analysis Services 或 Power BI Desktop 所導出的報表,這些報表相依於 MyWorkspace 中裝載的語意模型)
- 語意模型(除了推送數據集、Analysis Services 實時連線、模型 v1 除外)。
- Spark 作業定義
- Spark 環境
- 倉庫
如果工作區或 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 中命名資料夾時,如果項目的顯示名稱,邏輯識別碼 (Guid) 會在類型之前新增為前置詞:
- 超過256個字元
- 結尾為 。 或 空白
- 包含下列任何字元:“ / : ? < > \ * |
分支縮小限制
- 分支需要許可權數據表中所列的許可權。
- 此動作必須有可用的容量。
- 所有 工作區 和 分支命名限制 都會在分支至新的工作區時套用。
- 分支時,會建立新的工作區,而且不會複製原始工作區中的設定。 調整任何設定或定義,以確保新的工作區符合您組織的原則。
- 新的工作區中僅 提供 Git 支援的專案 。
- 相關的分支清單只會顯示您有權檢視的分支和工作區。
- 必須啟用 Git 整合 。
同步處理和認可限制
- 您一次只能以一個方向同步處理。 您無法同時認可和更新。
- 不支援敏感度標籤,而且可能會停用具有敏感度標籤的項目導出。 若要認可具有敏感度標籤且沒有敏感度標籤的專案, 請向系統管理員 尋求協助。
- 適用於 有限的專案。 資料夾中不支援的專案會被忽略。
- 不允許複製名稱。 即使 Power BI 允許重複名稱,更新、認可或復原動作也會失敗。
- 不支援 B2B。
- 衝突解決 是在 Git 中部分完成的。
- 在認可 Git 程式期間,Fabric 服務會刪除不屬於專案定義之專案資料夾內的檔案。 不會刪除不在項目資料夾中的不相關檔案。
- 認可變更之後,您可能會注意到您未進行的專案有一些非預期的變更。 這些變更在語意上微不足道,而且可能會因為數個原因而發生。 例如:
- 手動變更專案定義檔。 這些變更有效,但可能不同於透過編輯器完成的變更。 例如,如果您在 Git 中重新命名語意模型數據行,並將這項變更匯入至工作區,下次認可對語意模型的變更時, bim 檔案將會註冊為已變更,並將修改的數據行推送至數位背面
columns
。 這是因為產生 bim 檔案的 AS 引擎會將重新命名的數據行推送至陣列結尾。 這項變更不會影響項目的運作方式。 - 認可使用 CRLF 換行符的檔案。 服務使用 LF (換行字元) 換行符。 如果您在 Git 存放庫中 有具有 CRLF 換行符的專案檔案,當您從服務認可這些檔案時,這些檔案會變更為 LF。 例如,如果您在桌面中開啟報表,請 儲存 .pbip 專案,並使用 CRLF將其上傳至 Git。
- 手動變更專案定義檔。 這些變更有效,但可能不同於透過編輯器完成的變更。 例如,如果您在 Git 中重新命名語意模型數據行,並將這項變更匯入至工作區,下次認可對語意模型的變更時, bim 檔案將會註冊為已變更,並將修改的數據行推送至數位背面
- 使用增強式 重新整理 API 重新整理語意模型,會在每次重新整理之後產生 Git 差異。
相關內容
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應