Azure MCP 伺服器可讓您使用自然語言提示來管理 Azure 數據總管資源。 您可以列出叢集、檢視資料庫、使用自然語言查詢資料。 您也可以使用特定的 KQL 查詢來取得目標回應。
Azure 資料總 管是快速且完全受控的數據分析服務,可即時分析來自應用程式、網站、IoT 裝置等大量數據串流。 Azure 資料總管可協助您分析來自任何數據源的大量不同數據,例如網站、應用程式、IoT 裝置等等。
備註
工具參數:Azure MCP 伺服器工具會定義完成工作所需資料的參數。 其中一些參數是每個工具特有的,並記載於下方。 其他參數是全局參數,並由所有工具共用。 如需詳細資訊,請參閱 工具參數。
條件式參數
某些 Azure 資料總管工具需要交談內容中的下列 其中一個 參數集:
- 選項 1:叢集 URI
- 選項 2:叢 集名稱和訂 用帳戶
請勿將這三個參數(叢集 URI、叢集名稱和訂用帳戶)一起提供,因為這會產生衝突的輸入。
叢集:列出叢集
Azure MCP 伺服器會列出訂用帳戶中的所有 Azure 資料總管叢集。
範例提示包括:
- 列出叢集:「顯示我訂用帳戶中的所有 Azure 數據總管叢集」。
- 檢視叢集:「我可以使用哪些 Azure 數據總管叢集?
- 檢查叢集:「列出我的所有 Azure 數據總管叢集」。
- 查詢叢集:「顯示我的 Azure 數據總管叢集組織」。
- 尋找叢集:「取得 Azure 訂用帳戶中的所有 ADX 叢集」。
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌
叢集:取得叢集詳細資料
Azure MCP 伺服器會取得特定 Azure 資料總管叢集的詳細數據。
範例提示包括:
- 取得詳細數據:「顯示 Azure 數據總管叢集 』analytics-cluster' 的詳細數據」。
- 檢視叢集:「提供我 ADX 叢集 'logs-prod' 的相關信息」。
- 叢集資訊:「Azure 數據總管叢集 』data-explorer-dev' 的詳細數據為何?
- 檢查組態:「取得我的 ADX 叢集 'telemetry-cluster' 的設定詳細數據」。
- 叢集屬性:「在訂用帳戶 'my-sub' 中顯示 Azure 數據總管叢集的屬性」。
| 參數 | 必要或選用 | 說明 |
|---|---|---|
| 叢集 | 為必填項目 | Azure 數據總管叢集的名稱。 |
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌
資料庫:列出資料庫
Azure MCP 伺服器會列出 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 數據總管叢集的名稱。 |
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌
表格:清單表格
Azure MCP 伺服器會列出特定 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 數據總管資料庫的名稱。 |
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌
表格:取得表格結構描述
Azure MCP 伺服器會取得 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 數據總管資料庫的名稱。 |
| 表 | 為必填項目 | 數據表的名稱。 |
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌
範例數據
Azure MCP 伺服器會從指定的 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 數據總管資料庫的名稱。 |
| 表 | 為必填項目 | 要從中取樣數據的數據表名稱。 |
| 限制 | 可選 | 在範例中傳回的數據列數目上限。 |
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌
Query
Azure MCP 伺服器會針對 Azure 資料總管資料庫執行 KQL 查詢。
範例提示包括:
- 執行查詢:「在 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 查詢。 |
破壞性: ❌ |冪等: ✅ |開放世界: ❌ |只讀: ✅ |秘密: ❌ |本地要求: ❌