Power BI Desktop 專案語意模型資料夾

重要

Power BI Desktop 專案目前為預覽版。

本文說明 Microsoft Power BI Desktop 專案語意模型資料夾中的檔案和子資料夾。 此處的檔案和子資料夾代表 Power BI 語意模型。 視您的專案而定，語意模型資料夾可包含：

• .pbi\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• definition.pbism¹
• model.bim²
• definition\ folder³
• diagramLayout.json
• .platform

1 - 需要此檔案。
2 - 使用 TMSL 格式儲存時需要此檔案。
3 - 使用 TMDL 格式儲存時需要此檔案。

並非所有專案語意模型資料夾都包含此處描述的所有檔案和子資料夾。

語意模型檔案

.pbi\localSettings.json

包含僅適用於目前使用者和電腦的語意模型設定。 應該包含在 gitIgnore 或其他原始檔控制排除範圍中。 根據預設，Git 會忽略此檔案。

如需詳細資訊，請參閱 localSettings.json 結構描述文件。

.pbi\editorSettings.json

包含語意模型編輯器設定，儲存為語意模型定義的一部分，以用於使用者和環境。

如需詳細資訊，請參閱 editorSettings.json 結構描述文件。

.pbi\cache.abf

Analysis Services Backup (ABF) 檔案，其中包含上次編輯時模型與資料的本機快取複本。 應該包含在 gitIgnore 或其他原始檔控制排除範圍中。 根據預設，Git 會忽略此檔案。

Power BI Desktop 可以開啟沒有 cache.abf 檔案的專案。 在此情況下，會開啟與模型連線的報告及其整個定義，但不含資料。 如果 cache.abf 存在，Power BI Desktop 會載入資料，並使用 model.bim 中的內容覆寫模型定義。

.pbi\unappliedChanges.json

Power BI Desktop 可讓您儲存在轉換資料編輯器 (Power Query) 中所做的變更，而不需要先將這些變更套用至資料模型。

當您選取 [稍後套用] 時，未套用的變更會儲存到 unappliedChanges.json 檔案中。 當擱置變更位於 unappliedChanges 檔案中時，Power BI Desktop 會提示您套用或捨棄那些擱置變更：

如果您選取 [套用變更]，Power BI Desktop 會以來自 unappliedChanges.json 的查詢覆寫 model.bim 中的查詢。 如果您在 Power BI Desktop 外部的 model.bim 中編輯查詢，且有以前的 unappliedChanges.json 檔案，則套用這些變更時，您的變更會遺失，並取代為 unappliedChanges.json 中的查詢。

unappliedChanges.json 檔案會自動併入語意模型定義，並預設儲存在 Git 中。 這可讓您將持續的工作認可到開發分支，作為備份並讓其他小組成員存取。 不過，您可以將此檔案從 Git 的追蹤中排除，以防止未完成的查詢工作影響其他開發人員。

如需詳細資訊，請參閱 unappliedChanges.json 結構描述文件。

definition.pbism

包含語意模型和核心設定的整體定義。

此檔案也會透過 'version' 屬性指定支援的語意模型定義格式。

版本	支援的格式
1.0	語意模型定義必須儲存為 model.bim 檔案中的 TMSL。
4.0 以上	語意模型定義可以儲存為 TMSL (model.bim 檔案) 或 TMDL (\definition 資料夾)。

如需詳細資訊，請參閱 definition.pbism 結構描述文件。

model.bim

只有在使用 TMSL 格式儲存 Power BI 專案時，才能使用此檔案。 包含專案模型的表格式模型指令碼語言 (TMSL) 資料庫物件定義。

definition\ 資料夾

只有當 Power BI 專案是使用 TMDL 格式儲存時，才能使用此資料夾。 它會取代 model.bim 檔案。

此資料夾包含專案模型的表格式模型指令碼語言 (TMDL) 資料庫物件定義。

diagramLayout.json

包含圖表中繼資料，定義與報表相關聯的語意模型結構。 在預覽期間，此檔案不支援外部編輯。

功能。

保存屬性的網狀架構平台檔案，對於建立和維護 Fabric 項目與 Git 之間的連接至關重要。

若要深入了解，請參閱 Git 整合自動產生的系統檔案。

TMDL 格式

為了提供更好的原始檔控制和共同開發體驗，您可以使用表格式模型定義語言 (TMDL) 作為語意模型檔格式來儲存 Power BI 專案檔案 (PBIP)。

與表格式模型指令碼語言 (TMSL) 不同，TMDL 的設計從一開始就是人性化的，不僅有助於可讀性，而且在任何文字編輯器中都能輕鬆編輯。 這代表原始檔控制與共同作業開發體驗的大幅增強。

TMDL 沒有表格式模型指令碼語言 (TMSL) 之類的大型 JSON 檔案，而是具有資料夾結構，每個資料表、檢視方塊、角色和文化特性都有個別的檔案。 與其他人合作更輕鬆，只要查看資料夾和檔案就能了解語意模型結構。 最後，這會導致處理 git 差異和合併衝突時，提供絕佳的原始檔控制和共同開發體驗。

在這裡深入了解 TMDL。

啟用 TMDL 格式預覽功能

使用 TMDL 儲存為 Power BI 專案目前為預覽版。 使用之前，您必須先在預覽功能中加以啟用：

請前往 [檔案] > [選項及設定] > [選項] > [預覽功能]，然後選取 [使用 TMDL 格式儲存語意模型] 旁的方塊。

使用 TMDL 儲存為專案

啟用 TMDL 預覽功能時，當您儲存專案，語意模型會儲存為名為 \definition 的 TMDL 資料夾，而不是儲存為語意模型資料夾：

深入了解 TMDL 資料夾結構。

將現有的 PBIP 轉換為 TMDL

如果您已經有使用 TMSL 作為語意模型格式的 PBIP，您可以將其轉換成 TMDL，如下所示：

1. 在 Power BI Desktop 中開啟 PBIP。

2. 確定預覽功能已啟用。

3. 儲存專案。 出現提示，要求您升級至 TMDL。

4. 選取 [升級]。

   重要

   升級至 TMDL 之後，就無法還原回 TMSL。 如果您認為您可能會想要還原回 TMSL，請先儲存 PBIP 檔案的副本。

   

現有的表格式模型指令碼語言 (TMSL) 檔案 (model.bim) 會取代為包含語意模型 TMDL 表示法的 \definition 資料夾。

如果您選取 [保留目前] 格式，Desktop 不會再次提示升級。

對 TMDL 檔案進行外部變更

如需讀取和編輯 TMDL 檔案的較佳體驗，請安裝 TMDL - Visual Studio Marketplace Microsoft VS Code 延伸模組。

使用 VS Code 開啟 PBIP 資料夾，並瀏覽至語意模型定義資料夾。

Power BI Desktop 不知道其他工具對專案檔所做的變更。 因此，如果您對在 Power BI Desktop 外部開啟的檔案進行任何變更，則必須重新啟動，才能在 Power BI Desktop 中顯示這些變更。

如需 Power BI Desktop 外部支援的寫入作業，請參閱這裡。

TMDL 錯誤

如果對 TMDL 檔案進行任何無效的編輯，Power BI Desktop 會在開啟時擲回錯誤，包含出現錯誤的位置：

TMDL 考量與限制

在公開預覽期間，Fabric Git 整合預設仍會使用 TMSL 匯出語意模型。 不過，如果語意模型是使用 Fabric Git 整合與 TMDL 格式匯入 Fabric，則如果服務中有任何語意模型變更，Fabric Git 整合將會使用 TMDL 格式將語意模型定義匯出至 Git。

重要

如果您使用任何其他匯入方法匯入語意模型，例如 Power BI Desktop Publish，Fabric Git 整合會切換回預設 TMSL 格式。

相關內容

• Power BI Desktop 專案報表資料夾
• Power BI Desktop 專案
• 表格式模型指令碼語言 (TMSL)