使用 Git 管理工作區 （預覽）

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

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

建議您先閱讀 Git 整合 的概觀，再開始。

重要

這項功能處於預覽狀態。

必要條件

若要整合 Git 與您的 Microsoft Fabric 工作區，您必須在 Azure DevOps 和 Fabric 中設定下列必要條件。

Azure DevOps 必要條件

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

網狀架構必要條件

若要存取 Git 整合功能，您需要下列其中一項：

• Power BI 進階版 授權。 Power BI Premium 授權僅支援所有 Power BI 專案。
• 網狀架構容量。 需要 Fabric 容量，才能使用所有支援的 Fabric 專案。

此外，貴組織的系統管理員必須啟用 [使用者可以從 管理員 入口網站建立網狀架構專案租使用者切換。

將工作區 連線 至 Azure 存放庫

只有工作區管理員可以將工作區連線到 Azure 存放庫，但一旦連線，任何具有 許可權 的任何人都可以在工作區中工作。 如果您不是系統管理員，請洽詢系統管理員以取得連線的協助。 若要將工作區連線到 Azure 存放庫，請遵循下列步驟：

1. 登入Power BI並流覽至您想要連線的工作區。

2. 移至 工作區設定

   

   注意

   如果您沒有看到工作區設定圖示，請選取省略號（三個點），然後選取工作區設定。

3. 選取 [Git 整合]。 您會自動登入已註冊至 Microsoft Entra 使用者登入 Fabric 的 Azure Repos 帳戶。

   

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

   注意

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

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

5. 選取 [連線 並同步處理]。

在初始同步處理期間，如果工作區或 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 的連線

只有工作區管理員可以中斷工作區與 Azure 存放庫的連線。 如果您不是系統管理員，請要求系統管理員協助中斷連線。 如果您是系統管理員，且想要中斷存放庫的連線，請遵循下列步驟：

1. 移至 工作區設定

2. 選取 Git 整合

3. 選取 [中斷連線] 工作區

   

4. 再次選取 [ 中斷連線 ] 以確認。

   

權限

您可以對工作區採取的動作取決於您在工作區和 Azure DevOps 中擁有的許可權。 如需許可權的詳細討論，請參閱 許可權。

考量與限制

• 在認可 Git 程式期間，Fabric 服務會刪除不屬於專案定義之專案資料夾內的任何檔案。 不會刪除不在項目資料夾中的不相關檔案。

• 認可變更之後，您可能會注意到您未進行的專案有一些非預期的變更。 這些變更在語意上微不足道，而且可能會因為數個原因而發生。 例如：

  • 手動變更專案定義檔。 這些變更有效，但可能不同於透過編輯器完成的變更。 例如，如果您在 Git 中重新命名語意模型數據行，並將這項變更匯入至工作區，下次認可對語意模型的變更時， bim 檔案將會註冊為已變更，並將修改的數據行推送至數位背面 columns 。 這是因為產生 bim 檔案的 AS 引擎會將重新命名的數據行推送至陣列結尾。 這項變更不會影響項目的運作方式。

  • 認可使用 CRLF 換行符的檔案。 服務使用 LF （換行字元） 換行符。 如果您在 Git 存放庫中 有具有 CRLF 換行符的專案檔案，當您從服務認可這些檔案時，這些檔案會變更為 LF。 例如，如果您在桌面中開啟報表，請 儲存 .pbip 專案，並使用 CRLF將其上傳至 Git。

• 如果您遇到這些動作的問題，請務必瞭解 Git 整合功能的限制 。

相關內容

• 瞭解 Git 整合程式
• 管理 Git 分支
• Git 整合最佳做法