Git 與編頁報表整合

適用於： Power BI 服務 Power BI Report Builder Power BI Desktop

本文會逐步引導您發佈編頁報表，並讓報表與 Git 工作區保持同步。 開發人員可以套用其開發程序、工具和最佳做法。

必要條件

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

Fabric 先決條件

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

• Power BI Premium 授權。 Power BI Premium 授權僅支援所有 Power BI 項目。
• Fabric 容量。 需要 Fabric 容量才能使用所有支援的 Fabric 項目。 如果您還沒有 Fabric 容量，請註冊免費試用。

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

• 使用者可以建立 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 與 Microsoft Fabric 整合。

Power BI 必要條件

請參閱開始在 Power BI 服務中建立編頁報表中的必要條件一節。

將編頁報表新增至 GitHub

1. 遵循將工作區連線至 Azure 存放庫中的指示，將您的工作區連線至 Git 存放庫。

   

   注意

   如果分支是新的，系統會提示您建立及同步處理。

2. 將您的 .rdl 檔案上傳至服務上的工作區。 我們尚未支援 OneDrive 或 Sharepoint。

   

   上傳檔案之後，您應該會看到報表和 Git 狀態 [未認可] 和 [原始檔控制]。

   

3. 選取 [原始檔控制]。 在原始檔控制窗格中，選取檔案並認可。

   

   認可檔案之後，[Git 狀態] 會變更為 [同步]。

   

   資料夾會出現在您的 Git 存放庫中，其中包含 .rdl 和兩個 .json 檔案。 您可能需要重新整理存放庫。

   

編輯儲存至 GitHub 的編頁報表

1. 從 Power BI Report Builder 中的本機 Git 存放庫開啟 .rdl 檔案。
2. 進行所需的編輯。
3. 認可變更並將其推送至遠端存放庫。
4. 建立主分支的 PR。
5. 核准之後，PR 會合併至主分支。
6. 從主分支，將修訂後的變更套用至相關的工作區。

考量與限制

• 將編頁報表發佈/上傳至服務，然後使用 git。 如果您從 git 中的檔案開始，編頁報表不會轉譯。

• 當您從 git 刪除編頁報表時，請刪除整個資料夾，而不只是 .rdl 報表。

• 在 Git 中重新命名編頁報表無法運作。 不過，重新命名 Power BI 服務 上的 .rdl 會正常運作。 如果您想要重新命名編頁報告，您必須從 git 刪除編頁報告、刪除 整個資料夾，並使用新的名稱重新建立具有 .rdl 的資料夾。

• 當您將分頁報表移至不同的工作區時，分頁報表會維持與原始資料集的連線。 如果您將編頁報表移至不同的工作區，請更新 Power BI Report Builder 中的資料集，並將編頁報表重新發佈至 Power BI 服務。

下一步

• Git 整合簡介