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

重要

Power BI Desktop 專案目前為預覽狀態。

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

• .pbi\
  • local 設定.json
  • editor 設定.json
  • cache.abf
  • unappliedChanges.json
• definition.pbism¹
• model.bim²
• definition\ folder³
• diagramLayout.json
• 。平臺

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

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

語意模型檔案

.pbi\local 設定.json

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

如需詳細資訊，請參閱本機 設定.json 架構檔。

.pbi\editor 設定.json

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

如需詳細資訊，請參閱編輯器 設定.json 架構檔。

.pbi\cache.abf

Analysis Services 備份 （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檔案中。 當擱置中的變更位於未套用的Changes 檔案中時，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\ folder

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

此檔案包含 專案模型的表格式模型定義語言 （TMDL）資料庫物件 定義。

diagramLayout.json

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

功能。

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

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

TMDL 格式

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

與表格式模型腳本語言（TMSL）不同，TMDL 從頭開始設計為人類友好，不僅方便閱讀，而且可在任何文本編輯器中輕鬆編輯。 這代表原始檔控制與 共同作業 開發體驗的大幅增強。

TMDL 沒有表格式模型腳本語言（TMSL）之類的大型 JSON 檔案，而是具有資料夾結構，每個數據表、檢視方塊、角色和文化特性都有個別的檔案。 這可讓您更輕鬆地與其他人合作，並只查看資料夾和檔案來瞭解語意模型結構。 最後，這會導致處理 git diff 和合併衝突時的絕佳原始檔控制和共同開發體驗。

在這裡深入瞭解 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 資料夾。

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

對 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 會在開啟時擲回錯誤，並出現錯誤的位置：

Fabric Git 與 TMDL 整合

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

重要

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

相關內容

• Power BI Desktop 專案報表資料夾
• Power BI Desktop 專案
• 表格式模型文稿語言 （TMSL）