Git 統合ソース コード フォーマット

Microsoft Fabric のアイテムはフォルダーに格納されます。 アイテムを含むフォルダーは、ルート ディレクトリまたはサブディレクトリのどちらかに置くことができます。 ワークスペースを git に接続するときは、項目を含むフォルダーに接続します。 フォルダー内の各項目は、独自のサブディレクトリで表されます。 これらのアイテム ディレクトリは、アイテムの後にアイテムの種類が続くアイテム ディレクトリの名前と同じです。

重要

この機能はプレビュー中です。

各アイテム ディレクトリには、アイテム定義ファイルと 1 つまたは 2 つの自動生成されたシステム ファイルが含まれています。

項目定義ファイル

各アイテムのディレクトリには、そのアイテムを定義する特定の必須ファイルがあります。

現在、Microsoft Fabric では次のアイテムがサポートされています。

• ノートブック
• ページ分割されたレポート
• Report
• セマンティック モデル

ノートブック ファイル

ノートブック フォルダーには、.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 つのファイルすべてを入れることはできません。

Version 2

プラットフォーム ファイル

バージョン 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: (省略可能な文字列) 項目の説明。

Version 1

バージョン 1 を使用している場合は、各項目ディレクトリに次の 2 つのファイルがあります。

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

メタデータ ファイル

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

item.metadata.json ファイルには、次の属性が含まれています:

• type: (文字列) 項目の種類 (セマンティック モデル、レポートなど)
• displayName: (文字列) 項目の名前
• description: (省略可能な文字列) 項目の説明

アイテムの名前を変更するには、'item.metadata.json' ファイルの displayName を変更します。 フォルダーの名前を変更しても、ワークスペース内のアイテムの表示名は変更されません。

config ファイル

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

item.config.json ファイルには、次の属性が含まれています:

• version: システム ファイルのバージョン番号。 この数値は、下位互換性を有効にするために使用されます。 アイテムのバージョン番号が異なる場合があります。
• logicalId: 項目とそのソース管理表現を表す、自動的に生成されたクロスワークスペース識別子。

logicalId は、ワークスペース内のアイテムと、Git ブランチ内の対応するアイテムを接続します。 同じ logicalId を持つ項目は同じであると見なされます。 logicalId は、名前またはディレクトリが変更された場合でもリンクを保持します。 ブランチは複数のワークスペースに同期できるため、同じ logicalId を持つ異なるワークスペースにアイテムを含めることができますが、1 つのワークスペースに同じ logicalId を持つ 2 つのアイテムを含めることはできません。 logicalId は、ワークスペースが Git ブランチに接続されているとき、または新しいアイテムが同期されるときに作成されます。 logicalId は、Git 統合が正しく機能するのに必要です。 そのため、何らかの方法で変更しないことが不可欠です。

Note

バージョン 1 の Git に変更をコミットすると、システム ファイルは変更と共にバージョン 2 に自動的に更新されます。 また、Power BI Desktop 開発者モードからエクスポートされた新しいファイルは、バージョン 2 のファイル形式で保存されます。

Note

• Type フィールドでは、大文字と小文字が区別されます。 自動的に生成される方法や失敗する可能性がある方法は変更しないでください。
• 一般的に、logicalId やアイテムの表示名を変更する必要はありませんが、既存のアイテム ディレクトリをコピーして新しいアイテムを作成する場合は例外が 1 つあります。 その場合は、logicalId と表示名をリポジトリ内で一意のものに変更する必要があります。

関連するコンテンツ

Git 統合を開始する。