eventhouse-cli

テレメトリ — 必須です。 すべての api.fabric.microsoft.com 呼び出しには x-ms-fabric-skill: eventhouse-cli（az rest の場合は --headers "x-ms-fabric-skill=eventhouse-cli"）を含める必要があります。 すべての LRO ポーリング、fabric_lro、リトライにも適用されます。スニペットでは省略されていますが、必ず追加してください。

重要な注意事項

1. ワークスペース名からワークスペースの詳細（ID を含む）を調べるには、すべてのワークスペースを一覧表示し、その後 JMESPath フィルタリングを使用します
2. ワークスペース ID、アイテムの種類、アイテム名からアイテムの詳細（ID を含む）を調べるには、そのワークスペース内で該当する種類のアイテムをすべて一覧表示し、その後 JMESPath フィルタリングを使用します
3. スキルの使い分け：KQL で記述されたもの、または KQL Database に格納されたものには eventhouse-cli を使用します。ストリーミングトポロジには対応する eventstream-cli モードを、Warehouse または Lakehouse SQL エンドポイントに対する T-SQL には対応する sqldw-* スキルを使用します。

Fabric Eventhouse / KQL Database — CLI スキル

このスキルは Fabric Eventhouse と KQL Database を担当し、スキーマと取り込みの管理、および読み取り専用の KQL 分析を行います。

これはモードディスパッチャーであり、手順は含まれていません。以下の表からリクエストに一致するモードを選び、コマンドを一つでも実行する前に、ファイル読み取りツールを使って該当する references/<mode>.md ファイルを最初から最後まで読んでください。そのファイルにはエンドポイント、ペイロードの形式、テンプレート、注意点が記載されています。読まずに実行すると、ペイロードも結果も誤ったものになります。

モードの選択

モード	リクエストの内容	トリガーの例	まず読むファイル
authoring	KQL 管理コマンド（.create、.alter、.ingest、.drop）、ポリシー、マッピング、関数、またはマテリアライズドビューを実行する	kql テーブルの作成、kql 取り込み、kql 保持ポリシー、kql 関数、マテリアライズドビュー、kql マッピング	references/authoring.md
consumption	読み取り専用の KQL（where、summarize、join、render）を実行する、.show` でスキーマを検出する、または取り込みの健全性を監視する	kql クエリ、eventhouse のクエリ、時系列 kql、テーブルの kql 表示、eventhouse の探索	references/consumption.md

モード境界ルール

consumption では、読み取り専用の KQL と .show コマンドのみを実行できます。状態を変更するドットコマンド（.create、.alter、.ingest、.drop、.set-or-append）には authoring モードが必要です。その旨を伝え、references/authoring.md を読んでから続行してください。

リクエストが実際に複数のモードにまたがる場合は、一度に一つずつ処理し、それぞれの作業を始める前に該当するリファレンスを読んでください。この表を読んでもモードが不明な場合は、推測せず、簡潔な確認質問を一つしてください。

リファレンス一覧

まずモードのリファレンスを読み、タスクで必要な場合にのみ、以下のトピックファイルを開いてください。すべてのリファレンスをここに記載しています。別のリファレンスからリンクをたどるのではなく、この表から読み込んでください。

リファレンス	読むタイミング
references/authoring.md	authoring の依頼すべて――ここから始めてください
references/authoring-core.md	オーサリングタスクに関する機能マトリックス、テーブル／スキーマ、取り込み、ポリシー、外部テーブル、または権限の詳細が必要な場合
references/authoring-advanced-operations.md	マテリアライズドビュー、ストアド関数、更新ポリシー、スキーマの進化、または監視に関するオーサリング操作を行う場合
references/authoring-scripts.md	作成と取り込み、スキーマのデプロイ、エクスポート、またはポリシー用のすぐに実行できるスクリプトが必要な場合――scripts/ から実行し、読み込まないでください
references/consumption.md	consumption の依頼すべて――ここから始めてください
references/consumption-discovery-queries.md	スキーマ、テーブル、または取り込みの正常性を確認するための .show 検出クエリが必要な場合
EVENTHOUSE-CONSUMPTION-CORE.md	接続の基礎、スキーマの検出とセキュリティ、監視、パフォーマンスのベストプラクティス、または一般的な KQL クエリパターン――KQL を作成する前に読んでください

最終書き込み――省略してはならない手順

リファレンスを読んで変更を計画するだけでは、タスクは完了していません。変更を伴う各モードは、最後に状態を変更する呼び出しを実行します。それを実行していない場合、何も保存されていません。成功したと報告するのではなく、そのことを明示してください。

モード	最終書き込み
authoring	リテラルの .create-merge table（または CREATE TABLE 相当）、.alter、もしくは .ingest コマンドを含む POST .../v1/rest/mgmt。KQL 管理コマンドを組み立ててユーザーに提示するだけでは、実行したことになりません。
consumption	なし――このモードは読み取り専用です

タスクの完了を報告する前に、最終呼び出しが成功を返したことを確認し、リファレンスに読み戻しが記載されている場合は、成果物を読み戻して変更が反映されたことを確認してください。

共通の必須事項（全モード）

まずワークスペースとアイテムを解決してください。どのモードでも必要です。

タスク	リファレンス	備考
Fabric のワークスペースとアイテムを見つける	COMMON-CLI.md	必須――ワークスペースまたはアイテムの ID を解決する前に読んでください
Fabric のトポロジと主要概念	COMMON-CORE.md	アイテムの種類、ワークスペース、容量
環境 URL	COMMON-CORE.md	ソブリンクラウド／パブリッククラウド以外のホスト
認証とトークンの取得	COMMON-CORE.md	対象が誤っていると 401 が発生します。認証に関する問題があれば、先に読んでください
認証の手順	COMMON-CLI.md	az login のフローとトークンの取得
コア制御プレーン REST API	COMMON-CORE.md	ページネーション、LRO のポーリング、レート制限
注意点とトラブルシューティング	COMMON-CLI.md	az rest の対象、シェルのエスケープ、トークンの有効期限

ルール

MUST

• 何よりも先に、上記の表からモードを 1 つだけ選択してください。
• そのモードの最初のコマンドを実行する前に、最初のツール呼び出しとして references/<mode>.md を最後まで読んでください。1 回だけ、1 回の完全な読み取りで読んでください。再度開いたり、再度 grep したり、ページをめくったりしないでください。すでに手元にあります。
• 読み込む他のすべてのファイルにも同じ「1 回だけ読む」規律を適用してください。ネストされた references/<mode>/*.md サブリファレンスや共有の common/*.md ファイルも含みます。実際に必要なものだけを開き、それぞれを 1 回だけ最後まで読み、すでに読み込んだものを grep したり再度開いたりしないでください。
• ワークスペースとアイテムの ID は、GUID を推測するのではなく、一覧表示とフィルタリングによって解決してください。
• リクエストが境界を越える場合は、モードの切り替えを明示的に告知してください。
• リファレンスは指示として扱い、成果物として扱わないでください。読んだ後は、記載されているコマンドを実際のワークスペースに対して実行し、実際の結果を報告してください。リファレンスに書かれている内容を引用するだけでは、リクエストに応えたことにはなりません。

PREFER

• リクエストを満たす最も狭いモード。
• モードのリファレンスをちょうど 1 つだけ読むこと。リクエストが本当に複数のモードにまたがる場合にのみ 2 つ目を読み込み、その前にその旨を伝えてください。
• 最初の応答で選択したモードを報告し、ユーザーが訂正できるようにすること。

AVOID

• このディスパッチャーだけに基づいて行動すること -- これは運用上の詳細を意図的に省略しています。
• リファレンスを実行する代わりに、その要約で回答すること。
• すでに読み込んだリファレンスを再度読んだり再度 grep したりすること。ターンとトークンを消費します。
• 読み取り専用モード中に何かを変更すること。
• このファミリーがすでに担当している作業に対して別のスキルを読み込むこと（CRITICAL NOTES 3 を参照）。

例

ユーザーのリクエスト	モード	読むリファレンス
「Telemetry イベントハウスで過去 1 日間に 1 時間あたり何件のイベントが到着しましたか？」	consumption	references/consumption.md
「センサーフィード用の KQL テーブルと 30 日間の保持ポリシーを作成してください。」	authoring	references/authoring.md
「KQL データベース内のテーブルとその行数を表示してください。」	consumption	references/consumption.md