Eventhouse と KQL データベースの展開パイプラインと Git 統合 (プレビュー)

Eventhouse と KQL データベースは、Microsoft Fabric のライフサイクル管理機能と統合されました。これにより、製品の寿命を通じてすべての開発チーム メンバー間の標準化されたコラボレーションを提供します。 この機能は、Git 統合と展開パイプラインを介して提供されます。

この記事では、Microsoft Fabric のイベントハウスと KQL データベースのライフサイクル管理で使用できる構成オプションについて説明します。

Eventhouse と KQL データベースの Git 統合

イベントハウスと KQL データベースはメタデータとデータの両方を含む項目であり、ワークスペース内の複数のオブジェクトで参照されます。 Eventhouse と KQL データベースには、テーブル、関数、具体化されたビューが含まれています。 開発ワークフローの観点からは、次の依存オブジェクトがイベントハウスまたは KQL データベースを参照している可能性があります。

• Spark ジョブ定義
• Notebooks
• セマンティック モデルと Power BI

Git 統合は、イベントハウスと KQL データベースのプラットフォーム レベルとデータ レベルに適用されます。

プラットフォームレベルの統合

イベントハウスと KQL データベースの次の情報は、Git に接続されたワークスペースでシリアル化および追跡されます。

• Eventhouse

  • 名前
  • 説明
  • 論理 guid

• KQL データベース

  • 名前
  • 説明
  • キャッシュ ポリシー
  • 保持ポリシー
  • 論理 guid

データレベルの統合

データレベルの統合は、データベース オブジェクトのスキーマ、プロパティ、ポリシーを作成または変更する KQL スクリプトの使用によって実現します。 ただし、KQL スクリプトでサポートされているすべてのコマンドに Microsoft Fabric ALM との互換性があるわけではないことに注意してください。

• KQL データベース

  KQL スクリプトでは、次のデータベース オブジェクトがサポートされています。

  • テーブル
  • 機能
  • テーブル ポリシーの更新
  • 列のエンコード ポリシー
  • 具体化されたビュー
  • テーブル インジェスト マッピング

  サポートされているコマンドの詳細については、「KQL データベース ファイル」の DatabaseSchema.kql ファイルの説明を参照してください。

Git 統合の表現

Git と同期されるイベントハウスと KQL データベースの各項目は、次の形式の名前が付けられている独自のフォルダーに含まれます。<ItemName>.<ItemType> <ItemName> は項目の名前で、<ItemType> は項目の種類です。 たとえば、ExampleDB という名前の 1 つの KQL データベースを含む Example という名前のイベントハウスの場合は、Git リポジトリに次のフォルダーが表示されます。

• Example.Eventhouse
• ExampleDB.KQLDatabase

Eventhouse のファイル

イベントハウスのフォルダーには、次のファイルが含まれています。

• .platform

  このファイルは次のスキーマを使用してイベントハウスを定義します。

  {
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
    "metadata": {
      "type": "Eventhouse",
      "displayName": "",
      "description": ""
    },
    "config": {
      "version": "2.0",
      "logicalId": ""
    }
  }
  

• EventhouseProperties.json

  このファイルを使用すると、イベントハウス項目のプラットフォームレベルの設定を構成できます。

KQL データベースのファイル

KQL データベースのフォルダーには、次のファイルが含まれています。

• .platform

  このファイルは次のスキーマを使用して KQL データベースを定義します。

  {
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
    "metadata": {
      "type": "KQLDatabase",
      "displayName": "",
      "description": ""
    },
    "config": {
      "version": "2.0",
      "logicalId": ""
    }
  }
  

• DatabaseProperties.json

  このファイルは、次のスキーマを使用して、KQL データベース項目のプラットフォームレベルの設定を構成します。

  {
    "databaseType": "ReadWrite",
    "parentEventhouseItemId": "",
    "oneLakeCachingPeriod": "P36500D",
    "oneLakeStandardStoragePeriod": "P36500D"
  }
  

  次の表では、DatabaseProperties.json ファイルのプロパティについて説明します。

  プロパティ	説明
  databaseType	有効な値: ReadWrite
  parentEventhouseItemId	親イベントハウスの論理 ID。 これは変更しないでください。
  oneLakeCachingPeriod	キャッシュ ポリシーのデータベース レベルの設定。
  oneLakeStandardStoragePeriod	アイテム保持ポリシーのデータベース レベルの設定。

• DatabaseSchema.kql

  このファイルは、KQL データベースのデータレベル設定を構成する KQL スクリプトです。 これは KQL データベースが Git に同期されると自動的に生成されます。 このファイルは、Fabric ワークスペースと同期するときに実行されます。

  次のサポートされているコマンドを追加または変更して、このスクリプトを変更できます。

  データベースオブジェクト	サポートされているコマンド
  テーブル	作成またはマージ
  機能	作成または構造変更
  テーブル ポリシーの更新	Alter
  列のエンコード ポリシー	Alter
  具体化されたビュー	作成または構造変更
  テーブル インジェスト マッピング	作成または構造変更

  テーブルとそのインジェスト マッピングを作成する kql スクリプトの例を次に示します。

  // KQL script
  // Use management commands in this script to configure your database items, such as tables, functions, materialized views, and more.
  
  .create-merge table SampleTable (UsageDate:datetime, PublisherType:string, ChargeType:string, ServiceName:string, ServiceTier:string, Meter:string, PartNumber:string, CostUSD:real, Cost:real, Currency:string)
  .create-or-alter table SampleTable ingestion csv mapping 'SampleTable_mapping' "[{'Properties':{'Ordinal':'0'},'column':'UsageDate','datatype':''},{'Properties':{'Ordinal':'1'},'column':'PublisherType','datatype':''}]"
  

関連するコンテンツ

• Microsoft Fabric のライフサイクル管理とは?
• チュートリアル: Fabric でのライフサイクル管理
• Git 統合の概要
• デプロイ パイプラインの概要