Git 統合ソース コード フォーマット
Microsoft Fabric のアイテムはフォルダーに格納されます。 アイテムを含むフォルダーは、ルート ディレクトリまたはサブディレクトリのどちらかに置くことができます。 ワークスペースを git に接続するときは、項目を含むフォルダーに接続します。 フォルダー内の各項目は、独自のサブディレクトリで表されます。
ディレクトリ名
Git に新しい項目を保存すると、Git 統合によってその項目のディレクトリが自動的に作成されます。
項目のディレクトリ名は、次の規則に基づいています。
- 名前のパターンは
{display name}.{public facing type}です。 - 必要に応じて、表示名は次のように変更されます。
- そのフォルダー名を使用できない場合は、表示名の代わりにアイテムの logicalID (GUID) の名前が使用されます。
たとえば、ワークスペースに次の項目がある場合 (1 番目と 3 番目の項目の先頭と末尾にそれぞれ非表示のスペースがあることに注意してください):
Git リポジトリには、次のディレクトリが作成されます。
- 作成後、Git 統合によってディレクトリの名前が変更されることはありません。 アイテムの名前を変更しても、ディレクトリ名は変わりません。
- アイテム ディレクトリの名前を手動で変更する場合は、必ずアイテムの依存関係を考慮してください。 たとえば、セマンティック モデルのディレクトリを変更する場合は、レポートの依存関係ファイル内のセマンティック モデルのパスを必ず更新する必要があります。 依存関係の場所は、Fabric エクスペリエンスによって異なる点に注意してください。 ディレクトリ名を変更しても、ワークスペースに変更は反映 "されません"。
ディレクトリの内容
各項目のディレクトリには、項目定義ファイルと自動生成されたシステム ファイルが含まれます。
項目定義ファイル
各項目のディレクトリには、その項目を定義する特定の必須ファイルが含まれます。
現在、Microsoft Fabric では次のアイテムがサポートされています。
ノートブック ファイル
ノートブック フォルダーには、.py ファイルが入っています。
Git とノートブックの統合の使用方法については、「ノートブックのソース管理とデプロイの」を参照してください。
改ページ対応レポート ファイル
改ページ対応レポート フォルダーには、改ページ対応レポートを定義する .rdl ファイルが入っています。 RDL (レポート定義言語) は、改ページ対応レポート定義の XML 表現です。
RDL の詳細については、「レポート定義言語 (RDL)」を参照してください。 Git と改ページ対応レポートの統合の使用方法については、「Git と改ページ対応レポートの統合」を参照してください。
レポート ファイル
レポート フォルダーには、次のファイルが含まれています:
- definition.pbir
- report.json
レポート フォルダーとその内容の完全な一覧の詳細については、「Power BI Desktop プロジェクト レポート フォルダー」 を参照してください。
セマンティック モデル ファイル
セマンティック モデル フォルダーには、次のファイルが入っています。
- definition.pbidataset
- model.bim file (TMSL format) OR \definition folder (TMDL format)
セマンティック モデル フォルダーとそのコンテンツの完全な一覧の詳細については、「Power BI Desktop プロジェクトのセマンティック モデル フォルダー」を参照してください。
自動生成されたシステム ファイル
アイテム定義ファイルに加えて、各アイテム ディレクトリには、使用しているバージョンに応じて、自動的に生成されたシステム ファイルが 1 つまたは 2 つ入っています。
- バージョン 1 のディレクトリには、item.metadata.json と item.config.json が含まれています。 V1 では、両方のファイルがディレクトリに存在する必要があります。
- バージョン 2 のディレクトリに .platform が含まれています。 このファイルには、metadata.json ファイルと item.config.json ファイルの両方のコンテンツが含まれています。 このファイルがある場合は、他の 2 つのファイルを入れることができません。 バージョン 1 を使用していて変更をコミットする場合、システム ファイルはこのバージョンに自動的に更新されます。
Note
ディレクトリには、item.metadata.json ファイルと item.config.json ファイル、または .platform ファイルが含まれている必要があります。 3 つのファイルすべてを入れることはできません。
プラットフォーム ファイル
バージョン 2 では、各アイテム ディレクトリに 2 つのソース ファイルが存在するのではなく、.platform ファイルによってすべての情報が $schema プロパティとともに 1 つのファイルに結合されます。 このファイルがある場合は、他の 2 つのファイルを入れることができません。
{
"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: (省略可能な文字列) 項目の説明。
Note
- Type フィールドでは、大文字と小文字が区別されます。 自動的に生成される方法や失敗する可能性がある方法は変更しないでください。
- 一般的に、logicalId やアイテムの表示名を変更する必要はありませんが、既存のアイテム ディレクトリをコピーして新しいアイテムを作成する場合は例外が 1 つあります。 その場合は、logicalId と表示名をリポジトリ内で一意のものに変更する必要があります。