開始使用 Git 整合

本文章將引導您在 Microsoft Fabric 的 Git 整合工具中完成下列基本工作：

• 連線至 Git 存放庫
• 認可變更
• 從 Git 更新
• 中斷與 Git 的連線

建議您閱讀 Git 整合概觀後再開始。

必要條件

若要將 Git 與 Microsoft Fabric 工作區整合，需要先為 Fabric 和 Git 設定下列必要條件。

Fabric 先決條件

若要存取 Git 整合功能，您需要 Fabric 容量。 需要 Fabric 容量才能使用所有支援的 Fabric 項目。 如果您還沒有 Fabric 容量，請註冊免費試用。 已經有 Power BI Premium 容量的客戶可以使用該容量，但請記住，某些 Power BI SKU 僅支援 Power BI 專案。

此外，必須從管理入口網站啟用下列租用戶交換器：

• 使用者可以建立 Fabric 項目
• 使用者可以將工作區項目與 Git 存放庫同步處理
• 僅限 GitHub 使用者：使用者可以將工作區項目與 GitHub 存放庫同步處理

視貴組織的設定而定，租用戶管理員、容量管理員或工作區管理員可以啟用這些交換器。

Git 必要條件

Azure DevOps 和 GitHub 目前支援 Git 整合。 若要將 Git 整合與 Fabric 工作區搭配使用，Azure DevOps 或 GitHub 中需要滿足下列必備條件：

Azure DevOps 限制

• 向使用 Fabric 工作區的相同使用者註冊的作用中 Azure 帳戶。 建立免費帳戶。
• 存取現有的存放庫。

GitHub 限制

• 作用中的 GitHub 帳戶。 建立 GitHub 帳戶。

• 下列其中一個個人存取權杖：

  • 在存放庫權限下具有內容讀取和寫入權限的細部權杖 (推薦使用)：

    

    若要將此權杖與 GitHub Enterprise 搭配使用，請遵循這些指示。

  • 已啟用建立 GitHub 傳統權杖 (具備存放庫作用域)：

    

將工作區連線至 Git 存放庫

連線至 Git 存放庫

僅工作區管理員可以將工作區連線到存放庫，但一旦連線，具有權限的任何人都可以在工作區中工作。 如果您不是管理員，請向管理員尋求連線方面的協助。 若要將工作區連線至 Azure 或 GitHub 存放庫，請遵循下列步驟：

1. 登入 Fabric 並瀏覽至您想要連線的工作區。

2. 前往 [工作區設定]

   

3. 選取 [Git 整合]。

4. 選取 Git 提供者。 目前支援 Azure DevOps 和 GitHub。

連線至 Azure DevOps

如果您選取 Azure DevOps，請選取連線以自動登入已註冊至 Microsoft Entra 使用者的 Azure Repos 帳戶，該帳戶已登入 Fabric。

連線至 GitHub

如果您選取 GitHub，則必須登入 GitHub 帳戶。
如果您是第一次從 Fabric 登入，請選取 [新增帳戶]，或選取其中一個列出的帳戶。 登入之後，選取連線以允許 Fabric 存取您的 GitHub 帳戶。

如果是第一次連線，您必須授權 GitHub 使用者。 提供下列資訊：

• 顯示名稱 – 每個 GitHub 使用者的顯示名稱必須是唯一的
• 個人存取權杖 – - 您的傳統或細粒度個人存取權杖
• 存放庫網址 (選用) – 如果您未輸入存放庫網址，則可以連線到您有權存取的任何存放庫。 如果您輸入網址，則只能連線到該存放庫。

連線到工作區

如果工作區已連線到 GitHub，請遵循連線到共用工作區的指示。

Azure DevOps 分支連線

1. 從下拉式功能表中指定您要連線之分支的下列詳細資料：

   注意

   您一次只能將工作區連線到一個分支和一個資料夾。

   • 組織
   • 計畫
   • Git 存放庫。
   • 分支 (使用下拉式功能表選取現有分支，或選取[+ 新增分支]以建立新的分支。您一次只能連線到一個分支。)
   • 資料夾 (輸入現有資料夾的名稱，或輸入名稱以建立新資料夾。如果您將資料夾名稱留空，則會在根資料夾中建立內容。您一次只能連線到一個資料夾。)

GitHub 分支連線

1. 從下拉式功能表中指定您要連線之分支的下列詳細資料：

   注意

   您一次只能將工作區連線到一個分支和一個資料夾。

   • 存放庫網址。 如果您使用限定範圍的權杖連線到 GitHub，則存放庫網址會自動填入，而且您只能連線到該存放庫。
   • 分支 (使用下拉式功能表選取現有分支，或選取[+ 新增分支]以建立新的分支。您一次只能連線到一個分支。)
   • 資料夾 (輸入現有資料夾的名稱，或輸入名稱以建立新資料夾。如果您將資料夾名稱留空，則會在根資料夾中建立內容。您一次只能連線到一個資料夾。)

選取 [連線和同步]。

在初始同步處理期間，如果工作區或 Git 分支為空，則會將內容從非空位置拷貝到空位置。 如果工作區和 Git 分支均有內容，系統會詢問同步應遵循的方向。 如需此初始同步處理的詳細資訊，請參閱＜連線和同步＞。

連線之後，工作區會顯示原始檔控制的相關信息，可讓用戶檢視已連線的分支、分支中每個項目的狀態，以及上次同步的時間。

若要讓工作區與 Git 分支保持同步，請將您在工作區中所做的所有變更認可至 Git 分支，並在任何人建立新的變更認可至 Git 分支時更新至工作區。

將變更認可至 Git

成功連線到 Git 資料夾之後，請如往常一樣編輯工作區。 您儲存的任何變更只會儲存在工作區中。 準備就緒之後，您可以將變更認可至 Git 分支，也可以復原變更並還原為先前的狀態。 深入了解認可。

認可至 Git

若要將變更認可至 Git 分支，請遵循下列步驟：

1. 移至工作區。

2. 選取 [原始檔控制] 圖示。 此圖示會顯示未認可的變更數目。

3. 從 [原始檔控制] 面板選取 [變更]。 隨即出現一個清單，其中包含您更改的所有項目和指示項目狀態 (新的、已修改、衝突或已刪除) 的圖示。

4. 選取您要認可的項目。 若要選取所有項目，請選取頂端方塊。

5. 在方塊中新增註解。 如果您未新增註解，系統會自動新增預設訊息。

6. 選取 [認可]。

   

認可變更之後，已認可的項目會從清單中移除，而工作區會指向其已同步的新認可。

成功完成認可之後，所選取的項目的狀態會從 [未認可] 變更為 [已同步]。

復原已儲存的變更

將變更儲存至工作區之後，如果您決定不想將這些變更認可至 Git，則可以復原變更，並將這些項目還原為先前的狀態。 若要復原變更，請按照下列步驟執行：

1. 移至工作區。

2. 選取 [原始檔控制] 按鈕。 此按鈕也會顯示未認可的變更的數目。

3. 從 [原始檔控制] 面板選取 [變更]。 隨即出現一個清單，其中包含您更改的所有項目和指示已更改項目狀態 (新的、已修改、衝突或已刪除) 的圖示。

4. 選取您想要復原的變更。

5. 選取 [復原]。

   

6. 再次選取 [復原] 以確認操作。

   

工作區中已選取的項目會還原為工作區上次同步時的狀態。

重要

如果刪除某一項目，然後復原變更，則會重新建立該項目，並且部分中繼資料可能會遺失。 例如，敏感度標籤不會保留且應該重設，且項目的擁有者會設定為目前使用者。

從 Git 更新工作區

每當任何人認可新變更至已連線 Git 分支時，相關工作區中就會顯示通知。 使用 [原始檔控制] 面板來接收最新的變更、合併或還原到工作區並更新實時項目。 深入了解更新。

若要更新工作區，請按照下列步驟執行：

1. 移至工作區。
2. 選取 [原始檔控制] 圖示。
3. 從 [原始檔控制] 面板選取 [更新]。 隨即出現一個清單，其中包含自上次更新以來分支中已變更的所有項目。
4. 選取 [全部更新]。

成功更新之後，會移除項目清單，而工作區會指向其同步至的新認可。

成功完成更新之後，項目的狀態會變更為 [已同步]。

中斷工作區與 Git 的連線

只有工作區管理員可以中斷工作區與 Git 存放庫的連線。 如果您不是管理員，請向管理員尋求中斷連線方面的協助。 如果您是管理員，並且想要中斷存放庫的連線，請按照下列步驟執行：

1. 前往 [工作區設定]
2. 選取 [Git 整合]。
3. 選取 [中斷工作區連線]
4. 再次選取 [中斷連線] 以確認。

權限

您可以對工作區採取的動作取決於您在工作區和 Git 存放庫中擁有的權限。 若要了解有關權限的詳細資訊，請參閱＜權限＞。

考量與限制

Git 整合一般限制

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

Azure DevOps 限制

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

GitHub 限制

• 僅支援 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 分支
• Git 整合的最佳做法