共用方式為

Git 集成原始碼格式

Microsoft Fabric 中的項目儲存在資料夾中。 包含該項目的資料夾既可以位於根目錄，也可以位於子目錄中。 在將工作區連線至 Git 時，請連線到包含相關項目的資料夾。 資料夾中的每個項目均以自己的子目錄表示。

目錄名稱

當您在 Git 中儲存新專案時，Git 整合會自動建立該專案的目錄。

項目目錄名稱依據以下規則：

  • 名稱的模式為 {display name}.{public facing type}。
  • 如有必要，就會對顯示名稱進行下列變更：
    • 無效的字元會被替換為 HTML 碼。
    • 前導空格被替換成其 HTML 編號。
    • 尾端的空格或點會被替換成相應的HTML數字。
  • 如果該資料夾名稱無法使用，則會使用項目的邏輯ID（GUID）名稱，而不是顯示名稱。

例如，如果您在工作區中有下列項目（請注意，第一個項目和第三個項目分別有不可見的前置空格和尾端空格）：

Fabric 工作區中專案清單的螢幕快照。

Git 存放庫中會建立下列目錄：

包含 Fabric 專案的 Git 目錄名稱螢幕快照。

  • 一旦建立目錄名稱，Git 整合就永遠不會改變。 即使更改項目的名稱，目錄名稱仍會維持不變。
  • 如果手動更改項目目錄的名稱，請務必將項目的相依性納入考慮。 例如，如果更改語意模型的目錄，應務必更新報表的相依性檔案中語意模型的路徑。 請記住，相依性位置會因不同的 Fabric 體驗而異。 更改目錄名稱不會在工作區中引起新的變更。

目錄內容

每個項目目錄都包含 專案定義檔 和 自動產生的系統檔案。

項目定義檔案

每個項目的目錄都有定義該專案的特定必要檔案。

Microsoft Fabric 中目前支援下列項目：

鏡像資料庫

鏡像資料庫資料夾包含定義鏡像資料庫的 .json 檔案。

如需使用 Git 與鏡像資料庫整合的指示，請參閱 鏡像資料庫的 CI/CD。

筆記本檔案

筆記本資料夾包含一個 .py 檔案：

如需使用 Git 與筆記本整合的指導，請參閱筆記本原始檔控制和部署。

分頁報表檔案

編頁報表資料夾包含一個定義編頁報表的 .rdl 檔案。 報表定義語言 (RDL) 是編頁報表定義的 XML 表示法。

如需 RDL 的詳細資訊，請參閱 報表定義語言 （RDL）。 如需關於搭配使用 Git 整合與編頁報表的指示，請參閱＜Git 整合與編頁報表＞。

報表檔案

報表資料夾內含下列檔案：

  • definition.pbir
  • report.json

如需關於報表資料夾及其內容完整清單的詳細資訊，請參閱＜Power BI Desktop 專案報表資料夾＞。

語意模型檔案

語意模型資料夾內含下列檔案：

  • definition.pbism
  • 具有 TMDL 檔案的 \definition 資料夾

如需關於語意模型資料夾及其內容完整清單的詳細資訊，請參閱＜Power BI Desktop 專案語意模型資料夾＞。

自動產生的系統檔案

除了項目定義檔案之外，每個項目目錄都包含一或兩個自動產生的系統檔案，視您使用的版本而定：

  • 第 1 版目錄包含 item.metadata.json 和 item.config.json。 使用 V1 版本時，這兩個檔案都必須位於目錄中。
  • 第 2 版目錄包含 .platform。 此檔案包含 item.metadata.json 和 item.config.json 兩個檔案的內容。 如果有此檔案，則不能有其他兩個檔案。 如果您正在使用第 1 版並提交變更，則系統檔案會自動更新為此版本。

注意

目錄必須包含 item.metadata.json 和 item.config.json 檔案，或 檔案。 不能同時有這三個檔案。

平台檔案

在第 2 版中，.platform 檔案不是在每個項目目錄中都有兩個來源檔案，而是將所有資訊與 $schema 屬性一起合併到一個檔案中。 如果有此檔案，則不能有其他兩個檔案。

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

.platform 檔案包含下列屬性：

  • version：系統檔案的版本號碼。 此號碼用來啟用回溯相容性。 項目的版本號碼可能不同。
  • logicalId：（字串）一個自動生成的跨工作區識別碼，代表項目及其源代碼控制表示。
  • type：(字串) 項目類型 (語意模型、報表等)
  • displayName：(字串) 項目的名稱。
  • description：(選用字串) 項目的描述。

如果您在工作區中重新命名成品，且 Git 中的成品資料夾具有 '.' 尾碼，那麼在提交後，displayName 和 Git 目錄名稱將會相符。

logicalId 連接工作區中的項目與 Git 分支中與其對應的項目。 具有相同 logicalId 的項目會被視為是同一個項目。 即使名稱或目錄發生更改，logicalId 仍會保留連結。 由於分支可以同步至多個工作區，因此不同工作區中的項目可能具有相同的 logicalId，但單一工作區中不能有兩個具有相同 logicalId 的項目。 當工作區連線到 Git 分支或同步新項目時，就會建立 logicalId。 logicalId 對於 Git 整合的正常運作必不可少。 因此，請務必不要以任何方式對其進行更改。

注意

當你在 Git 中提交變更至第 1 版時，系統檔案會連同變更自動更新為第 2 版。 此外，從 Power BI Desktop 開發人員模式匯出的任何新檔案都會以第 2 版檔案格式進行儲存。

注意

  • type 欄位需區分大小寫。 請勿更改其自動產生的方式，否則可能會失敗。
  • 雖然通常情況下不應該更改項目的 logicalId 或顯示名稱，但若是要透過拷貝現有的項目目錄來建立新項目，是一個例外狀況。 在此情況下，您確實需要將 logicalId 和 顯示名稱 更改為存放庫中唯一的名稱。

相關內容

開始使用 Git 整合。

  • Last updated on