この記事では、Microsoft Power BI Desktop プロジェクトのセマンティック モデル フォルダー内のファイルとサブフォルダーについて説明します。 ここでのファイルとサブフォルダーは、Power BI セマンティック モデルを表します。 プロジェクトに応じて、セマンティック モデル フォルダーには以下のものが含まれます。
- .pbi\
- DAXQueries\ フォルダー
- TMDLScripts\ フォルダー
- 定義\ フォルダー3
- model.bim2
- diagramLayout.json
- プラットフォーム
- definition.pbism1
1 - このファイルは必須です。
2 - このファイルは、TMSL 形式を使用して保存する場合に必須です。
3 - このファイルは、TMDL 形式を使用して保存する場合に必須です。
すべてのプロジェクトのセマンティック モデル フォルダーに、ここで説明するすべてのファイルとサブフォルダーが含まれているわけではありません。
セマンティック モデル ファイル
.pbi\localSettings.js
現在のユーザーとコンピューターにのみ適用されるセマンティック モデル設定が含まれています。 gitIgnore、またはその他のソース管理の除外対象に含める必要があります。 Git では、既定でこのファイルが無視されます。
詳しくは、localSettings.json スキーマのドキュメントを参照してください。
.pbi\editorSettings.jsオン
セマンティック モデル定義の一部として保存され、複数のユーザーや環境間で使用できるセマンティック モデル エディターの設定が含まれています。
詳しくは、editorSettings.json スキーマのドキュメントを参照してください。
.pbi\cache.abf
最後に編集したときのモデルとデータのローカル キャッシュ コピーを含む Analysis Services Backup (ABF) ファイル。 gitIgnore、またはその他のソース管理の除外対象に含める必要があります。 Git では、既定でこのファイルが無視されます。
cache.abf ファイルがないプロジェクトでも、Power BI Desktop で開くことができます。 その場合、定義をすべて使い、データは使わずに、モデルに接続されたレポートが開きます。 cache.abf が存在する場合、Power BI Desktop はデータを読み込み、プロジェクト内のセマンティック モデル メタデータでモデル定義を上書きします。
.pbi\unappliedChanges.json
Power BI Desktop を使うと、Transform Data エディター (Power Query) で行った変更を、最初にデータ モデルに適用することなく保存できます。
![クエリ変更の [適用] ダイアログを示す画像。](media/projects-overview/query-change.png)
[後で適用] を選ぶと、適用されていない変更は unappliedChanges.json ファイルに保存されます。 適用されていない変更が unappliedChanges ファイルにある場合、Power BI Desktop により、その保留中の変更を適用するか破棄するように求められます。
[変更の 適用] を選択した場合、Power BI Desktop はセマンティック モデル メタデータ内のクエリを unappliedChanges.jsonからのクエリで上書きします。 Power BI Desktop の外部でクエリを編集し、以前の 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
このファイルは、Power BI プロジェクトが TMSL 形式で保存されている場合にのみ使用できます。 プロジェクト モデルの表形式モデル スクリプト言語 (TMSL) データベース オブジェクトの定義が含まれています。
definition\ フォルダー
このフォルダーが利用できるのは、Power BI プロジェクトが TMDL 形式を使用して保存されている場合だけです。 これにより、model.bim ファイルが置き換えられます。
このフォルダーには、プロジェクト モデルの テーブル モデル定義言語 (TMDL)Database オブジェクト 定義が含まれています。
diagramLayout.json
レポートに関連付けられたセマンティック モデルの構造を定義するダイアグラムのメタデータが含まれています。 このファイルを外部で編集することはできません。
プラットフォーム
Fabric アイテムと Git 間の接続を確立および保守するのに不可欠なプロパティを保持する Fabric プラットフォーム ファイル。
詳しくは、Git 統合の自動生成されるシステム ファイルに関する記事を参照してください。
DAXQueries\ フォルダー
DAX ファイルとして保存された各 [Tab name].daxクエリ タブのファイルが含まれています。
.pbi\daxQueries.json
defaultTab やタブ オーダーなどの DAX クエリ ビュー エディターの設定が含まれています。
TMDLScripts\ フォルダー
各 TMDL ビュー スクリプトタブが [Tab name].tmdl TMDL ファイルとして保存されたファイルが含まれています。
.pbi\tmdlscripts.json
defaultTab やタブ オーダーなどの TMDL ビュー エディターの設定が含まれています。
TMDL 形式
ソース管理と共同開発エクスペリエンスを向上させるために、表形式モデル定義言語 (TMDL) をセマンティック モデル ファイル形式として使用して Power BI プロジェクト ファイル (PBIP) を保存することができます。
表形式モデル スクリプト言語 (TMSL) とは異なり、TMDL は人間にとって扱いやすいように一から設計されており、"読みやすい" だけでなく、任意のテキスト エディターで簡単に "編集" できます。 これは、ソース管理と "共同" 開発エクスペリエンスが大幅に強化されることを意味します。
TMDL では、表形式モデル スクリプト言語 (TMSL) のような大きな JSON ファイルではなく、テーブル、パースペクティブ、ロール、カルチャごとに個別のファイルを含むフォルダー構造を使用します。 これにより、他のユーザーと共同作業しやすくなり、フォルダーとファイルを見るだけでセマンティック モデルの構造を簡単に理解できます。 最終的には、git diff とマージの競合を扱う際の、ソース管理と共同開発の優れたエクスペリエンスにつながります。
TMDL について詳しくは、こちらを参照してください。
TMDL ファイルを外部から変更する
TMDL ファイルは、Visual Studio Codeまたは別の外部ツールで編集できますが、プロジェクトは Power BI Desktop で開いたままです。 TMDL 編集エクスペリエンスを向上するために、Visual Studio Codeの TMDL 拡張機能をインストールします。
ファイルを外部で編集する前に、Power BI Desktop に変更を保存します。 VS Code で PBIP フォルダーを開き、セマンティック モデル definition フォルダーに移動し、TMDL の変更を保存します。 Power BI Desktop は、保存された変更を検出し、[外部変更の適用] バナーを表示します。 プロジェクトを閉じて再度開かずにセマンティック モデルを再読み込みするには、[ 外部変更の適用 ] を選択します。
Power BIデスクトップに保存されていない変更がある場合は、外部の変更を適用すると上書きされることを警告します。 完全なワークフローと制限事項については、「Power BI Desktop の外部で PBIP ファイルを編集する」を参照してください。
Power BI Desktop 以外でサポートされている書き込み操作については、「モデルの作成」を参照してください。
TMDL エラー
TMDL 編集が無効な場合、外部の変更を適用するか、プロジェクトを開いたときに、Power BI Desktop にエラーが表示されます。 このエラーは、Power BI Desktop が更新されたセマンティック モデルを読み込む前に修正する必要がある場所を識別します。
