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\ フォルダー³
• 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 では、既定でこのファイルが無視されます。

cache.abf ファイルがないプロジェクトでも、Power BI Desktop で開くことができます。 その場合、定義をすべて使い、データは使わずに、モデルに接続されたレポートが開きます。 cache.abf が存在する場合、Power BI Desktop によってデータが読み込まれ、モデル定義は model.bim の内容で上書きされます。

.pbi\unappliedChanges.json

Power BI Desktop を使うと、Transform Data エディター (Power Query) で行った変更を、最初にデータ モデルに適用することなく保存できます。

[後で適用] を選ぶと、適用されていない変更は unappliedChanges.json ファイルに保存されます。 適用されていない変更が unappliedChanges ファイルにある場合、Power BI Desktop により、その保留中の変更を適用するか破棄するように求められます。

[変更の適用] を選ぶと、Power BI Desktop により、model.bim のクエリは unappliedChanges.json のクエリで上書きされます。 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

このファイルは、Power BI プロジェクトが TMSL 形式で保存されている場合にのみ使用できます。 プロジェクト モデルの表形式モデル スクリプト言語 (TMSL) データベース オブジェクトの定義が含まれています。

definition\ フォルダー

このフォルダーが利用できるのは、Power BI プロジェクトが TMDL 形式を使用して保存されている場合だけです。 これにより、model.bim ファイルが置き換えられます。

このフォルダーには、プロジェクト モデルの表形式モデル定義言語 (TMDL)データベース オブジェクト定義が含まれています。

diagramLayout.json

レポートに関連付けられたセマンティック モデルの構造を定義するダイアグラムのメタデータが含まれています。 プレビュー中は、このファイルで外部編集はサポートされません。

プラットフォームにユーザーを追加します。

Fabric アイテムと Git 間の接続を確立および保守するのに不可欠なプロパティを保持する Fabric プラットフォーム ファイル。

詳しくは、Git 統合の自動生成されるシステム ファイルに関する記事を参照してください。

TMDL 形式

ソース管理と共同開発エクスペリエンスを向上させるために、表形式モデル定義言語 (TMDL) をセマンティック モデル ファイル形式として使用して Power BI プロジェクト ファイル (PBIP) を保存することができます。

表形式モデル スクリプト言語 (TMSL) とは異なり、TMDL は人間にとって扱いやすいように一から設計されており、"読みやすい" だけでなく、任意のテキスト エディターで簡単に "編集" できます。 これは、ソース管理と "共同" 開発エクスペリエンスが大幅に強化されることを意味します。

TMDL では、表形式モデル スクリプト言語 (TMSL) のような大きな JSON ファイルではなく、テーブル、パースペクティブ、ロール、カルチャごとに個別のファイルを含むフォルダー構造を使用します。 これにより、他のユーザーと共同作業しやすくなり、フォルダーとファイルを見るだけでセマンティック モデルの構造を簡単に理解できます。 最終的には、git diff とマージの競合を扱う際の、ソース管理と共同開発の優れたエクスペリエンスにつながります。

TMDL について詳しくは、こちらを参照してください。

TMDL 形式のプレビュー機能を有効にする

TMDL を使った Power BI プロジェクトとしての保存は、現在プレビュー段階です。 お使いになる前に、まず [プレビュー機能] で有効にする必要があります。

[ファイル] > [オプションと設定] > [オプション] > [プレビュー機能] に移動し、[Store semantic model using TMDL format] (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 の [発行] などの他のインポート方法を使用してセマンティック モデルをインポートする場合、Fabric Git 統合では既定の TMSL 形式に戻ります。

関連するコンテンツ

• Power BI Desktop プロジェクト レポート フォルダー
• Power BI Desktop プロジェクト
• Tabular Model Scripting Language (TMSL)