Azure Data Explorer 工具的 Azure MCP 伺服器概述

Azure MCP 伺服器可讓您使用自然語言提示來管理 Azure 數據總管資源。 您可以列出叢集、檢視資料庫、使用自然語言查詢資料。 您也可以使用特定的 KQL 查詢來取得目標回應。

Azure 資料總 管是快速且完全受控的數據分析服務,可即時分析來自應用程式、網站、IoT 裝置等大量數據串流。 Azure 資料總管可協助您分析來自任何數據源的大量不同數據,例如網站、應用程式、IoT 裝置等等。

備註

工具參數:Azure MCP 伺服器工具會定義完成工作所需資料的參數。 這些參數中有些是針對每種工具而定,並在此處有詳細說明。 其他參數是全局參數,並由所有工具共用。 如需詳細資訊,請參閱 工具參數

條件式參數

某些 Azure 資料總管工具需要交談內容中的下列 其中一個 參數集:

  • 選項 1:叢集 URI
  • 選項 2:叢集名稱和訂閱服務

請勿將這三個參數(叢集 URI、叢集名稱和訂用帳戶)一起提供,因為這會產生衝突的輸入。

叢集:列出叢集

Azure MCP 伺服器會列出訂用帳戶中的所有 Azure 資料總管叢集。

範例提示包括:

  • 列出叢集:「顯示我訂用帳戶中的所有 Azure 數據總管叢集」。
  • 檢視叢集:「我可以使用哪些 Azure 數據總管叢集?
  • 檢查叢集:「列出我的所有 Azure 數據總管叢集」。
  • 查詢叢集:「顯示我的 Azure 數據總管叢集組織」。
  • 尋找叢集:「取得 Azure 訂用帳戶中的所有 ADX 叢集」。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修

叢集:取得叢集詳細資料

Azure MCP 伺服器會取得特定 Azure 資料總管叢集的詳細數據。

範例提示包括:

  • 取得詳細資訊:「顯示我的 Azure 資料探索器叢集 'analytics-cluster' 的詳細資訊」。
  • 檢視叢集:「請給我 ADX 叢集 'logs-prod' 的相關資訊」。
  • 叢集資訊:「Azure 數據總管叢集 』data-explorer-dev' 的詳細數據為何?
  • 檢查組態:「取得我的 ADX 叢集 'telemetry-cluster' 的設定詳細數據」。
  • 叢集屬性:「在訂用帳戶 'my-sub' 中顯示 Azure 數據總管叢集的屬性」。
參數 必要或選用 說明
叢集 為必填項目 Azure 數據總管叢集的名稱。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修

資料庫:列出所有資料庫

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 數據總管叢集的名稱。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修

表格:清單表格

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 數據總管資料庫的名稱。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修

表格:取得表格結構描述

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 數據總管資料庫的名稱。
為必填項目 數據表的名稱。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修

範例數據

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 數據總管資料庫的名稱。
為必填項目 要從中取樣數據的數據表名稱。
限制 可選 傳回範例中的最大行數上限。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修

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 查詢。

工具註解提示

破壞性 冪等 開放世界 唯讀 Secret 本地必修