Azure MCP 伺服器允許您使用自然語言提示來管理 Azure Data Explorer 資源。 你可以用自然語言列出叢集、查看資料庫並查詢資料。 您也可以使用特定的 KQL 查詢來取得目標回應。
Azure 資料總 管是快速且完全受控的數據分析服務,可即時分析來自應用程式、網站、IoT 裝置等大量數據串流。 Azure 資料總管可協助您分析來自任何數據源的大量不同數據,例如網站、應用程式、IoT 裝置等等。
備註
工具參數:Azure MCP 伺服器工具會定義完成工作所需資料的參數。 這些參數中有些是針對每種工具而定,並在此處有詳細說明。 其他參數是全局參數,並由所有工具共用。 如需詳細資訊,請參閱 工具參數。
條件式參數
某些 Azure 資料總管工具需要交談內容中的下列 其中一個 參數集:
-
選項 1:叢集 URI
-
選項 2:叢集名稱和訂閱服務
當你提供叢集名稱時,可從你設定的 Azure 內容中解析出訂閱。 如果你提供叢集 URI,工具會使用該 URI;此時不需要叢集名稱和訂閱。 這些資料平面工具不需要資源群組。
叢集:列出叢集
範例 CLI 指令
azmcp kusto cluster list \
[--resource-group <resource-group>]
| 參數 |
類型 |
為必填項目 |
說明 |
resource-group |
字串 |
No |
將叢集限制在這個資源群。 省略此項,以列出跨訂用帳戶的叢集。 |
範例提示包括:
-
列出叢集:「顯示我訂用帳戶中的所有 Azure 數據總管叢集」。
-
檢視叢集:「我可以使用哪些 Azure 數據總管叢集?
-
檢查叢集:「列出我的所有 Azure 數據總管叢集」。
-
查詢叢集:「顯示我的 Azure 數據總管叢集組織」。
-
尋找叢集:「取得 Azure 訂用帳戶中的所有 ADX 叢集」。
| 參數 |
必要或選用 |
說明 |
|
資源群組 |
可選 |
將叢集限制在這個資源群。 省略此項,以列出訂閱中的叢集。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
叢集:取得叢集詳細資料
範例 CLI 指令
azmcp kusto cluster get \
--cluster <cluster>
| 參數 |
類型 |
為必填項目 |
說明 |
cluster |
字串 |
Yes |
Azure 數據總管叢集的名稱。 |
範例提示包括:
-
取得詳細資訊:「顯示我的 Azure 資料探索器叢集 'analytics-cluster' 的詳細資訊」。
-
檢視叢集:「請給我 ADX 叢集 'logs-prod' 的相關資訊」。
-
叢集資訊:「Azure 數據總管叢集 』data-explorer-dev' 的詳細數據為何?
-
檢查組態:「取得我的 ADX 叢集 'telemetry-cluster' 的設定詳細數據」。
-
叢集屬性:「在訂閱 'my-sub' 中顯示我的 Azure Data Explorer 叢集 'analytics-cluster' 的屬性。」
| 參數 |
必要或選用 |
說明 |
|
叢集 |
為必填項目 |
Azure 數據總管叢集的名稱。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
資料庫:列出所有資料庫
範例 CLI 指令
azmcp kusto database list \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| 參數 |
類型 |
為必填項目 |
說明 |
cluster-uri |
字串 |
No |
Azure 數據總管叢集的 URI。 |
cluster |
字串 |
No |
Azure 數據總管叢集的名稱。 |
範例提示包括:
-
列出資料庫:「顯示 Azure Data Explorer 叢集 'analytics-cluster' 中的所有資料庫。」
-
檢視資料庫:「我的 ADX 叢集 』analytics-cluster' 中有哪些資料庫?
-
檢查資料庫:「列出資料總管叢集 'analytics-cluster' 中的所有資料庫。」
-
查詢資料庫:「在 Azure 數據總管叢集 URI 'https://mycluster.westus.kusto.windows.net' 中顯示資料庫。」
-
尋找資料庫:「從 ADX 叢集 'analytics-cluster' 取得所有資料庫。」
| 參數 |
必要或選用 |
說明 |
|
叢集 URI |
條件式需求 |
Azure 數據總管叢集的 URI。 |
|
叢集 |
條件式需求 |
Azure 數據總管叢集的名稱。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
表格:清單表格
範例 CLI 指令
azmcp kusto table list \
--database <database> \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| 參數 |
類型 |
為必填項目 |
說明 |
database |
字串 |
Yes |
Azure 數據總管資料庫的名稱。 |
cluster-uri |
字串 |
No |
Azure 數據總管叢集的 URI。 |
cluster |
字串 |
No |
Azure 數據總管叢集的名稱。 |
範例提示包括:
-
列表表格:「顯示我 Azure Data Explorer 叢集 'analytics-cluster' 的 'log' 資料庫中的所有表格。」
-
檢視資料表:「在 ADX 叢集 'analytics-cluster' 中,我在資料庫 'telemetry' 裡有哪些資料表?」
-
檢查表格:「列出叢集 'analytics-cluster' 中 Azure Data Explorer 資料庫 'analytics' 的所有表格。」
-
查詢表格:「顯示資料總管叢集『analytics-cluster』中' metrics' 資料庫中的表格。」
-
尋找資料表:「從 Azure Data Explorer 叢集 'analytics-cluster' 的 'events' 資料庫取得所有資料表。」
| 參數 |
必要或選用 |
說明 |
|
叢集 URI |
條件式需求 |
Azure 數據總管叢集的 URI。 |
|
叢集 |
條件式需求 |
Azure 數據總管叢集的名稱。 |
|
資料庫 |
為必填項目 |
Azure 數據總管資料庫的名稱。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
表格:取得表格結構描述
範例 CLI 指令
azmcp kusto table schema \
--table <table> \
--database <database> \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| 參數 |
類型 |
為必填項目 |
說明 |
table |
字串 |
Yes |
Azure Data Explorer 資料表的名稱。 |
database |
字串 |
Yes |
Azure 數據總管資料庫的名稱。 |
cluster-uri |
字串 |
No |
Azure 數據總管叢集的 URI。 |
cluster |
字串 |
No |
Azure 數據總管叢集的名稱。 |
範例提示包括:
-
檢視架構:「顯示 Azure Data Explorer 叢集 'analytics-cluster' 中資料庫 'logs' 中'Events' 表格的結構。」
-
取得結構:「在 ADX 叢集的資料庫『遙測』中,『指標』表格有哪些欄位?」
-
檢查結構:「描述資料總管叢集『analytics-cluster』中資料庫『日誌』中的『日誌』資料表。」
-
檢視欄位:「在 Azure Data Explorer 叢集 'analytics-cluster' 中,資料庫 'telemetry' 中顯示 'Telemetry' 表格的欄位與類型。」
-
檢視表:「取得 ADX 叢集『analytics-cluster』中資料庫『日誌』中『Traces』資料表的結構。」
| 參數 |
必要或選用 |
說明 |
|
叢集 URI |
條件式需求 |
Azure 數據總管叢集的 URI。 |
|
叢集 |
條件式需求 |
Azure 數據總管叢集的名稱。 |
|
資料庫 |
為必填項目 |
Azure 數據總管資料庫的名稱。 |
|
表 |
為必填項目 |
數據表的名稱。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
範例數據
範例 CLI 指令
azmcp kusto sample \
--table <table> \
--database <database> \
[--limit <limit>] \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| 參數 |
類型 |
為必填項目 |
說明 |
table |
字串 |
Yes |
Azure Data Explorer 資料表的名稱。 |
database |
字串 |
Yes |
Azure 數據總管資料庫的名稱。 |
limit |
字串 |
No |
要傳回的結果數目上限。 必須是介於1到10000之間的正整數。 預設值為 10。 |
cluster-uri |
字串 |
No |
Azure 數據總管叢集的 URI。 |
cluster |
字串 |
No |
Azure 數據總管叢集的名稱。 |
範例提示包括:
-
取得範例資料:「請在 Azure Data Explorer 叢集 'analytics-cluster' 的資料庫『日誌』中,顯示『Events』資料表中的資料範例。」
-
預覽表:「請先預覽 ADX 叢集 'analytics-cluster' 中資料庫 'logs' 中 'Logs' 表中的紀錄。」
-
查看資料範例:「在資料總覽叢集 'analytics-cluster' 中,顯示資料庫『遙測』中『Metrics』資料表中的範例列。」
-
檢查資料格式:「從 Azure Data Explorer 叢集 'analytics-cluster' 資料庫 'telemetry' 的『Telemetry』資料表取得幾個範例紀錄,以查看資料結構。」
-
資料探索:「從 ADX 叢集『analytics-cluster』中資料庫『logs』的『UserActivity』表中回傳 10 個範例列。」
| 參數 |
必要或選用 |
說明 |
|
叢集 URI |
條件式需求 |
Azure 數據總管叢集的 URI。 |
|
叢集 |
條件式需求 |
Azure 數據總管叢集的名稱。 |
|
資料庫 |
為必填項目 |
Azure 數據總管資料庫的名稱。 |
|
表 |
為必填項目 |
要從中取樣數據的數據表名稱。 |
|
限制 |
可選 |
傳回範例中的最大行數上限。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
Query
範例 CLI 指令
azmcp kusto query \
--query <query> \
--database <database> \
[--cluster-uri <cluster-uri>] \
[--cluster <cluster>]
| 參數 |
類型 |
為必填項目 |
說明 |
query |
字串 |
Yes |
要執行的 Kusto 查詢語言(KQL)查詢。 |
database |
字串 |
Yes |
Azure 數據總管資料庫的名稱。 |
cluster-uri |
字串 |
No |
Azure 數據總管叢集的 URI。 |
cluster |
字串 |
No |
Azure 數據總管叢集的名稱。 |
範例提示包括:
-
執行查詢:「在 Azure Data Explorer 叢集 'analytics-cluster' 中的 'logs' 資料庫,執行 'Logs | where Timestamp > ago(1h) | count'。」
-
查詢資料:「執行 KQL 查詢『日誌 |其中 Level ==「Error」及 Timestamp > ago(24h)',用以查找 ADX 叢集 'analytics-cluster' 資料庫日誌中過去 24 小時內的所有錯誤。」
-
擷取資料:「從 Data Explorer 叢集『analytics-cluster』的資料庫『日誌』中查詢 'Events | take 100' 來獲取最近的事件。」
-
擷取洞察:「使用 'UserActivity | summarize count() by UserId' 從 Azure Data Explorer 叢集 'analytics-cluster' 的資料庫 'logs' 中查詢使用者活動模式。」
-
分析日誌:「執行 KQL 的指標 |「按服務彙總平均(Duration)」以彙整資料庫中各服務的效能指標,該資料庫的『遙測』在 ADX 叢集『analytics-cluster』中。」
| 參數 |
必要或選用 |
說明 |
|
叢集 URI |
條件式需求 |
Azure 數據總管叢集的 URI。 |
|
叢集 |
條件式需求 |
Azure 數據總管叢集的名稱。 |
|
資料庫 |
為必填項目 |
Azure 數據總管資料庫的名稱。 |
|
查詢 |
為必填項目 |
要執行的 KQL 查詢。 |
工具註解提示:
| 破壞性 |
冪等 |
開放世界 |
唯讀 |
Secret |
本地必修 |
| ❌ |
✅ |
❌ |
✅ |
❌ |
❌ |
相關內容