使用适用于 Azure MCP 服务器的 Kusto 工具的 Azure 数据资源管理器

Azure MCP 服务器允许使用自然语言提示管理 Azure 数据资源管理器资源。 可以列出群集、查看数据库、查询数据等,而无需记住复杂的 Kusto 查询语言 (KQL) 语法。

Azure 数据资源管理器 是一项快速、完全托管的数据分析服务,用于实时分析来自应用程序、网站、IoT 设备等的大量数据流。 Azure 数据资源管理器可帮助你分析来自任何数据源的大量不同数据,例如网站、应用程序、IoT 设备等。

注释

Azure MCP 服务器工具为完成任务所需的数据定义参数。 其中一些参数特定于每个工具,如下所示。 其他参数是全局参数,由所有工具共享。 有关详细信息,请参阅 工具参数

条件参数

某些包含 Kusto 工具的 Azure 数据资源管理器需要在聊天上下文中使用以下参数集 之一

  • 选项 1:群集 URI
  • 选项 2群集名称和订阅

不要同时提供所有三个参数(群集 URI、群集名称和订阅),因为这会产生冲突的输入。

列出群集

Azure MCP 服务器可以列出订阅中的所有 Kusto 群集。

示例提示包括:

  • 列出群集:“显示订阅中的所有 Kusto 群集。
  • 查看群集:“我有哪些 Azure 数据资源管理器群集可用?”
  • 检查群集:“列出所有 Kusto 群集”。
  • 查询群集:“显示我的 Kusto 群集组织”。
  • 查找群集:“获取 Azure 订阅中的所有 ADX 群集。
参数 必需还是可选 DESCRIPTION
订阅 必选 Azure 订阅 ID 或名称。

获取群集详细信息

Azure MCP 服务器可以获取特定 Kusto 群集的详细信息。

示例提示包括:

  • 获取详细信息:“显示 Kusto 群集”analytics-cluster“的详细信息。
  • 查看群集:“告诉我有关 ADX 群集”logs-prod“的信息。
  • 群集信息:“Kusto 群集”data-explorer-dev“的详细信息是什么?
  • 检查配置:“获取 ADX 群集”telemetry-cluster“的配置详细信息。
  • 群集属性:“在订阅”my-sub“中显示 Kusto 群集的属性。
参数 必需还是可选 DESCRIPTION
订阅 必选 Azure 订阅 ID 或名称。
群集名称 必选 Kusto 群集的名称。

列出数据库

Azure MCP 服务器可以列出 Kusto 群集中的所有数据库。

示例提示包括:

  • 列出数据库:“显示 Kusto 群集中的所有数据库。
  • 查看数据库:“我的 ADX 群集”analytics-cluster“中有哪些数据库?
  • 检查数据库:“列出数据资源管理器群集中的所有数据库。
  • 查询数据库:“在 Kusto 群集 URI ''https://mycluster.westus.kusto.windows.net中显示数据库。”
  • 查找数据库:“从 ADX 实例获取所有数据库”。
参数 必需还是可选 DESCRIPTION
群集 URI 有条件 地必需 Kusto 群集的 URI。
订阅 有条件 地必需 Azure 订阅 ID 或名称。
群集名称 有条件 地必需 Kusto 群集的名称。

列出表格

Azure MCP 服务器可以列出特定 Kusto 数据库中的所有表。

示例提示包括:

  • 列出表:“显示 Kusto 群集”日志“数据库中的所有表。
  • 查看表:“我的 ADX 群集中的数据库”遥测“中有哪些表?
  • 检查表:“列出 Kusto 数据库”analytics“中的所有表。
  • 查询表:“显示数据资源管理器群集的”指标“数据库中的表。
  • 查找表:“从 Kusto 实例中的”events“数据库中获取所有表。
参数 必需还是可选 DESCRIPTION
群集 URI 有条件 地必需 Kusto 群集的 URI。
订阅 有条件 地必需 Azure 订阅 ID 或名称。
群集名称 有条件 地必需 Kusto 群集的名称。
数据库名称 必选 Kusto 数据库的名称。

获取表架构

Azure MCP 服务器可以获取 Kusto 数据库中特定表的架构。

示例提示包括:

  • 查看架构:“显示 Kusto 数据库中”事件“表的架构。
  • 获取结构:“我的 ADX 数据库中”指标“表具有哪些列?
  • 检查架构:“描述数据资源管理器数据库中的”日志“表。
  • 查看列:“在 Kusto 中显示”遥测“表的列和类型。
  • 检查表:“获取 ADX 数据库中”Traces“表的结构。
参数 必需还是可选 DESCRIPTION
群集 URI 有条件 地必需 Kusto 群集的 URI。
订阅 有条件 地必需 Azure 订阅 ID 或名称。
群集名称 有条件 地必需 Kusto 群集的名称。
数据库名称 必选 Kusto 数据库的名称。
表名称 必选 表的名称。

执行查询

Azure MCP 服务器可以针对 Kusto 数据库执行 KQL 查询。

示例提示包括:

  • 运行查询:“执行'日志 |where Timestamp > ago(1h) | count' in my Kusto database.
  • 查询数据:“运行 KQL 查询以查找 ADX 数据库中过去 24 小时内的所有错误。
  • 提取数据:“使用查询从数据资源管理器数据库获取最近的事件。
  • 提取见解:“从 Kusto 数据库查询用户活动模式。
  • 分析日志:“执行 KQL 以按我的 ADX 数据库中的服务汇总性能指标。
参数 必需还是可选 DESCRIPTION
群集 URI 有条件 地必需 Kusto 群集的 URI。
订阅 有条件 地必需 Azure 订阅 ID 或名称。
群集名称 有条件 地必需 Kusto 群集的名称。
数据库名称 必选 Kusto 数据库的名称。
查询 必选 要执行的 KQL 查询。

示例表数据

Azure MCP 服务器可以从指定的 Kusto 表中检索数据示例。

示例提示包括:

  • 获取示例数据:“显示 Kusto 数据库中”事件“表中的数据示例。
  • 预览表:“为我提供 ADX 数据库中”Logs“表中记录的预览。
  • 查看数据示例:“在数据资源管理器数据库中显示”指标“表中的示例行。
  • 检查数据格式:“从 Kusto 的”遥测“表中获取一些示例记录以查看数据结构。
  • 数据浏览:“从 ADX 群集中的”UserActivity“表中返回 10 个示例行。
参数 必需还是可选 DESCRIPTION
群集 URI 有条件 地必需 Kusto 群集的 URI。
订阅 有条件 地必需 Azure 订阅 ID 或名称。
群集名称 有条件 地必需 Kusto 群集的名称。
数据库名称 必选 Kusto 数据库的名称。
表名称 必选 要从中采样数据的表的名称。
限制 可选 在示例中返回的最大行数。