Azure MCP サーバーを使用すると、自然言語プロンプトを使用して Azure Data Explorer リソースを管理できます。 複雑な Kusto クエリ言語 (KQL) 構文を覚えずに、クラスターの一覧表示、データベースの表示、データのクエリなどを行うことができます。
Azure Data Explorer は、アプリケーション、Web サイト、IoT デバイスなどの大量のデータ ストリーミングをリアルタイムで分析するための、高速でフル マネージドのデータ分析サービスです。 Azure Data Explorer は、Web サイト、アプリケーション、IoT デバイスなど、あらゆるデータ ソースから大量の多様なデータを分析するのに役立ちます。
注
Azure MCP Server ツールは、タスクを完了するために必要なデータのパラメーターを定義します。 これらのパラメーターの一部は、各ツールに固有であり、以下に記載されています。 その他のパラメーターはグローバルであり、すべてのツールで共有されます。 詳細については、「 ツールパラメーター」を参照してください。
条件付きパラメーター
一部の Azure Data Explorer ツールでは、会話コンテキスト内で次 のいずれかの パラメーター セットが必要です。
- オプション 1: クラスター URI
- オプション 2: クラスター名とサブスクリプション の 両方
競合する入力が作成されるため、3 つのパラメーター (クラスター URI、クラスター名、サブスクリプション) をすべて一緒に指定しないでください。
クラスターを一覧表示する
Azure MCP サーバーでは、サブスクリプション内のすべての Azure Data Explorer クラスターを一覧表示できます。
プロンプトの例を次に示します。
- クラスターの一覧表示: "サブスクリプション内のすべての Azure Data Explorer クラスターを表示する"
- クラスターの表示: "使用可能な Azure Data Explorer クラスターは何ですか?
- クラスターを確認します。"すべての Azure Data Explorer クラスターを一覧表示する"
- クエリ クラスター: "Azure Data Explorer クラスター組織を表示する"。
- クラスターを検索します。"Azure サブスクリプション内のすべての ADX クラスターを取得します。"
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| サブスクリプション | 必須 | Azure サブスクリプション ID または名前。 |
クラスターの詳細の取得
Azure MCP サーバーは、特定の Azure Data Explorer クラスターの詳細を取得できます。
プロンプトの例を次に示します。
- 詳細を取得します。"Azure Data Explorer クラスター 'analytics-cluster' の詳細を表示します。
- クラスターの表示: "ADX クラスター 'logs-prod' に関する情報を提供してください。"
- クラスター情報: "Azure Data Explorer クラスター 'data-explorer-dev' の詳細は何ですか?
- 構成を確認します。"ADX クラスター 'telemetry-cluster' の構成の詳細を取得します。
- クラスターのプロパティ: "サブスクリプション 'my-sub' に Azure Data Explorer クラスターのプロパティを表示します。"
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| サブスクリプション | 必須 | Azure サブスクリプション ID または名前。 |
| [Cluster name](クラスター名) | 必須 | Azure Data Explorer クラスターの名前。 |
データベースを一覧表示する
Azure MCP サーバーでは、Azure Data Explorer クラスター内のすべてのデータベースを一覧表示できます。
プロンプトの例を次に示します。
- データベースの一覧表示: "Azure Data Explorer クラスター内のすべてのデータベースを表示する"。
- データベースの表示: "ADX クラスター 'analytics-cluster' にはどのようなデータベースがありますか?
- データベースを確認します。"Data Explorer クラスター内のすべてのデータベースを一覧表示します。"
- データベースのクエリ: "Azure Data Explorer クラスター URI 'https://mycluster.westus.kusto.windows.net' にデータベースを表示します。
- データベースを検索します。"ADX インスタンスからすべてのデータベースを取得します。"
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| クラスター URI | 条件付きで 必須 | Azure Data Explorer クラスターの URI。 |
| サブスクリプション | 条件付きで 必須 | Azure サブスクリプション ID または名前。 |
| [Cluster name](クラスター名) | 条件付きで 必須 | Azure Data Explorer クラスターの名前。 |
テーブルを一覧表示する
Azure MCP サーバーでは、特定の Azure Data Explorer データベース内のすべてのテーブルを一覧表示できます。
プロンプトの例を次に示します。
- テーブルの一覧: "Azure Data Explorer クラスターの 'logs' データベース内のすべてのテーブルを表示する"
- テーブルの表示: "ADX クラスターのデータベース 'telemetry' に含まれるテーブルは何ですか?
- テーブルを確認します。"Azure Data Explorer データベース 'analytics' のすべてのテーブルを一覧表示します。
- クエリ テーブル: "Data Explorer クラスターの "メトリック" データベースにテーブルを表示します。
- テーブルを検索します。"Azure Data Explorer インスタンス内の 'events' データベースからすべてのテーブルを取得します。"
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| クラスター URI | 条件付きで 必須 | Azure Data Explorer クラスターの URI。 |
| サブスクリプション | 条件付きで 必須 | Azure サブスクリプション ID または名前。 |
| [Cluster name](クラスター名) | 条件付きで 必須 | Azure Data Explorer クラスターの名前。 |
| データベース名 | 必須 | Azure Data Explorer データベースの名前。 |
テーブル スキーマを取得する
Azure MCP サーバーは、Azure Data Explorer データベース内の特定のテーブルのスキーマを取得できます。
プロンプトの例を次に示します。
- スキーマの表示: "Azure Data Explorer データベースの 'Events' テーブルのスキーマを表示してください。"
- 構造を取得する: "ADX データベースに 'Metrics' テーブルがある列は何ですか?
- スキーマを確認します。"Data Explorer データベースの 'Logs' テーブルについて説明します。"
- 列の表示: "Azure Data Explorer で 'Telemetry' テーブルの列と型を表示する"。
- テーブルを調べます。"ADX データベース内の 'Traces' テーブルの構造を取得します。"
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| クラスター URI | 条件付きで 必須 | Azure Data Explorer クラスターの URI。 |
| サブスクリプション | 条件付きで 必須 | Azure サブスクリプション ID または名前。 |
| [Cluster name](クラスター名) | 条件付きで 必須 | Azure Data Explorer クラスターの名前。 |
| データベース名 | 必須 | Azure Data Explorer データベースの名前。 |
| テーブル名 | 必須 | テーブルの名前。 |
クエリの実行
Azure MCP サーバーは、Azure Data Explorer データベースに対して KQL クエリを実行できます。
プロンプトの例を次に示します。
- クエリの実行: "Execute 'Logs |ここで、Timestamp > ago(1h) | count' in my Azure Data Explorer database"。
- クエリ データ: "KQL クエリを実行して、過去 24 時間以内のすべてのエラーを ADX データベースで検索します"。
- データをフェッチする: "クエリを使用して Data Explorer データベースから最近のイベントを取得する"。
- 分析情報を抽出する: "Azure Data Explorer データベースからユーザー アクティビティ パターンにクエリを実行する"
- ログを分析する: "KQL を実行して、ADX データベース内のサービス別のパフォーマンス メトリックを集計する"。
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| クラスター URI | 条件付きで 必須 | Azure Data Explorer クラスターの URI。 |
| サブスクリプション | 条件付きで 必須 | Azure サブスクリプション ID または名前。 |
| [Cluster name](クラスター名) | 条件付きで 必須 | Azure Data Explorer クラスターの名前。 |
| データベース名 | 必須 | Azure Data Explorer データベースの名前。 |
| クエリ | 必須 | 実行する KQL クエリ。 |
サンプル テーブル データ
Azure MCP サーバーは、指定された Azure Data Explorer テーブルからデータのサンプルを取得できます。
プロンプトの例を次に示します。
- サンプル データを取得する: "Azure Data Explorer データベースの 'Events' テーブルからデータのサンプルを表示します。"
- プレビュー テーブル: "ADX データベースの 'Logs' テーブルのレコードのプレビューを表示してください。"
- データの例を表示する: "Data Explorer データベースの "Metrics" テーブルのサンプル行を表示します。
- データ形式を確認します。"Azure Data Explorer の 'Telemetry' テーブルからいくつかのサンプル レコードを取得して、データ構造を確認します。"
- データ探索: "ADX クラスター内の 'UserActivity' テーブルから 10 行のサンプル行を返します。"
| パラメーター | 必須または省略可能 | 説明 |
|---|---|---|
| クラスター URI | 条件付きで 必須 | Azure Data Explorer クラスターの URI。 |
| サブスクリプション | 条件付きで 必須 | Azure サブスクリプション ID または名前。 |
| [Cluster name](クラスター名) | 条件付きで 必須 | Azure Data Explorer クラスターの名前。 |
| データベース名 | 必須 | Azure Data Explorer データベースの名前。 |
| テーブル名 | 必須 | データのサンプリングの対象となるテーブルの名前。 |
| 制限 | オプション | サンプルで返される行の最大数。 |