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

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

Screenshot of Git directory containing items.

重要

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

各項目ディレクトリ内には、項目定義ファイルの他に、各ディレクトリに自動生成されたシステム ファイルが 2 つあります。

項目定義ファイル

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

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

ノートブック ファイル

ノートブック フォルダーには、.py ファイルが入っています。

Screenshot of directory tree showing files in the notebook directory.

Git とノートブックの統合の使用方法については、「ノートブックのソース管理とデプロイの」を参照してください。

改ページ対応レポート ファイル

改ページ対応レポート フォルダーには、改ページ対応レポートを定義する .rdl ファイルが入っています。 RDL (レポート定義言語) は、改ページ対応レポート定義の XML 表現です。

RDL の詳細については、「レポート定義言語 (RDL)」を参照してください。 Git と改ページ対応レポートの統合の使用方法については、「Git と改ページ対応レポートの統合」を参照してください。

レポート ファイル

レポート フォルダーには、次のファイルが含まれています:

  • definition.pbir
  • report.json

Screenshot of directory tree showing files in the report directory.

レポート フォルダーとその内容の完全な一覧の詳細については、「Power BI Desktop プロジェクト レポート フォルダー」 を参照してください。

セマンティック モデル ファイル

セマンティック モデル フォルダーには、次のファイルが入っています。

  • definition.pbidataset
  • model.bim file (TMSL format) OR \definition folder (TMDL format)

セマンティック モデル フォルダーとそのコンテンツの完全な一覧の詳細については、「Power BI Desktop プロジェクト データセット フォルダー」を参照してください。

自動生成されたシステム ファイル

項目定義ファイルに加えて、各項目ディレクトリには、使っているバージョンに応じて、自動的に生成された 2 つのシステム ファイルが含まれています。

メタデータ ファイル

{ 
    "type": "report", 
    "displayName": "Cool Blue",
    "description": "First quarter status 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

一般的に、logicalIdアイテムの表示名を変更する必要はありませんが、既存のアイテム ディレクトリをコピーして新しいアイテムを作成する場合は例外が 1 つあります。 その場合は、logicalId表示名をリポジトリ内で一意のものに変更する必要があります。

Git 統合を開始する