Обзор средств Azure Data Explorer для сервера Azure MCP

Сервер Azure MCP позволяет управлять ресурсами Azure Data Explorer с помощью запросов естественного языка. Вы можете перечислять кластеры, просматривать базы данных, запрашивать данные с помощью естественного языка. Вы также можете использовать определенные запросы KQL для целевых ответов.

Azure Data Explorer — это быстрая полностью управляемая служба аналитики данных для анализа больших объемов потоков данных из приложений, веб-сайтов, устройств Интернета вещей и т. д. Azure Data Explorer помогает анализировать большие объемы различных данных из любого источника данных, таких как веб-сайты, приложения, устройства Интернета вещей и многое другое.

Замечание

Параметры средства. Средства Azure MCP Server определяют параметры для данных, необходимых для выполнения задач. Некоторые из этих параметров относятся к каждому инструменту и описаны ниже. Другие параметры являются глобальными и общими для всех инструментов. Дополнительные сведения см. в разделе "Параметры средства".

Условные параметры

Для некоторых средств Azure Data Explorer требуется один из следующих наборов параметров в контексте беседы:

  • Вариант 1. URI кластера
  • Вариант 2: Имя кластера и подписка

Не предоставляйте все три параметра (URI кластера, имя кластера и подписку), так как это создает конфликтующие входные данные.

Кластер: список кластеров

Сервер Azure MCP содержит все кластеры Azure Data Explorer в подписке.

Примеры запросов:

  • Список кластеров: "Показать все кластеры Azure Data Explorer в моей подписке".
  • Просмотр кластеров: "Какие кластеры Azure Data Explorer доступны?"
  • Проверьте кластеры: "Список всех кластеров Azure Data Explorer".
  • Запрос кластеров: "Показать мою организацию кластера Azure Data Explorer".
  • Найдите кластеры: "Получение всех кластеров ADX в моей подписке Azure".

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Кластер: получение сведений о кластере

Сервер Azure MCP получает сведения для конкретного кластера Azure Data Explorer.

Примеры запросов:

  • Получение сведений: "Показать сведения о моем кластере Azure Data Explorer 'analytics-cluster'."
  • Просмотр кластера: "Предоставление мне сведений о кластере ADX "logs-prod".
  • Сведения о кластере: "Каковы сведения о кластере Azure Data Explorer "data-explorer-dev"?
  • Проверить конфигурацию: "Получите сведения о конфигурации моего кластера ADX 'telemetry-cluster'."
  • Свойства кластера: "Показать свойства кластера Azure Data Explorer в подписке "my-sub".
Параметр Обязательно или необязательно Описание
Гроздь Обязательно Имя кластера Azure Data Explorer.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

База данных: список баз данных

Сервер Azure MCP содержит все базы данных в кластере Azure Data Explorer.

Примеры запросов:

  • Список баз данных: "Показать все базы данных в кластере Azure Data Explorer "analytics-cluster".
  • Просмотр баз данных: "Какие базы данных имеются в кластере ADX "analytics-cluster"?
  • Просмотр баз данных: "Перечислить все базы данных в кластере Data Explorer «analytics-cluster»."
  • Запрос баз данных: "Показать базы данных в URIhttps://mycluster.westus.kusto.windows.net кластера Azure Data Explorer".
  • Поиск баз данных: "Получение всех баз данных из кластера ADX "analytics-cluster".
Параметр Обязательно или необязательно Описание
URI кластера Условно обязательный Унифицированный идентификатор ресурса (URI) кластера Azure Data Explorer.
Гроздь Условно обязательный Имя кластера Azure Data Explorer.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Таблица: перечень таблиц

Сервер Azure MCP содержит все таблицы в определенной базе данных Azure Data Explorer.

Примеры запросов:

  • Список таблиц: "Показать все таблицы в базе данных logs" кластера Azure Data Explorer "analytics-cluster".
  • Просмотр таблиц: "Какие таблицы имеются в базе данных "телеметрия" в кластере ADX "analytics-cluster"?"
  • Проверка таблиц: "Список всех таблиц в базе данных Azure Data Explorer 'аналитика' в кластере 'аналитика-кластер'."
  • Таблицы запросов: "Показать таблицы в базе данных метрик" кластера Data Explorer "analytics-cluster".
  • Найдите таблицы: "Получение всех таблиц из базы данных 'events' в кластере Azure Data Explorer 'analytics-cluster'."
Параметр Обязательно или необязательно Описание
URI кластера Условно обязательный Унифицированный идентификатор ресурса (URI) кластера Azure Data Explorer.
Гроздь Условно обязательный Имя кластера Azure Data Explorer.
База данных Обязательно Имя базы данных Azure Data Explorer.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Таблица: получение схемы таблицы

Сервер Azure MCP получает схему определенной таблицы в базе данных Azure Data Explorer.

Примеры запросов:

  • Просмотр схемы: "Покажи мне схему таблицы 'События' в базе данных 'логов' в кластере Azure Data Explorer 'analytics-cluster'."
  • Получение структуры: "Какие столбцы имеет таблица "Метрики" в базе данных "телеметрия" в кластере ADX "analytics-cluster"?"
  • Проверьте схему: «Опишите таблицу 'Logs' в базе данных 'logs' в кластере Data Explorer 'analytics-cluster'.»
  • Просмотр столбцов: "Отображение столбцов и типов для таблицы "Телеметрия" в базе данных "телеметрия" в кластере Azure Data Explorer "analytics-cluster".
  • Изучите таблицу: "Получите структуру таблицы 'Traces' в базе данных 'logs' в кластере ADX 'analytics-cluster'."
Параметр Обязательно или необязательно Описание
URI кластера Условно обязательный Унифицированный идентификатор ресурса (URI) кластера Azure Data Explorer.
Гроздь Условно обязательный Имя кластера Azure Data Explorer.
База данных Обязательно Имя базы данных Azure Data Explorer.
Таблица Обязательно Название таблицы.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Примерные данные

Сервер Azure MCP извлекает образец данных из указанной таблицы Azure Data Explorer.

Примеры запросов:

  • Получите пример данных: "Показать пример данных из таблицы "События" в базе данных "журналы" в кластере Azure Data Explorer "analytics-cluster".
  • Просмотр таблицы: "Предоставьте мне просмотр записей из таблицы 'Logs' в базе данных 'logs' в кластере ADX 'analytics-cluster'."
  • Просмотрите примеры данных: "Показать примеры строк из таблицы "Метрики" в базе данных "телеметрия" в кластере Data Explorer "analytics-cluster".
  • Проверьте формат данных: "Получите несколько примеров записей из таблицы 'Telemetry' в базе данных 'telemetry' в кластере Azure Data Explorer 'analytics-cluster', чтобы увидеть структуру данных".
  • Исследование данных: "Верните 10 строк-примеров из таблицы «UserActivity» в базе данных «logs» в кластере ADX analytics-cluster."
Параметр Обязательно или необязательно Описание
URI кластера Условно обязательный Унифицированный идентификатор ресурса (URI) кластера Azure Data Explorer.
Гроздь Условно обязательный Имя кластера Azure Data Explorer.
База данных Обязательно Имя базы данных Azure Data Explorer.
Таблица Обязательно Имя таблицы для выборки данных из.
Ограничение Необязательно Максимальное количество строк, возвращаемых в примере.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Query

Сервер Azure MCP выполняет запрос KQL к базе данных Azure Data Explorer.

Примеры запросов:

  • Выполнение запроса: "Выполнение журналов | where Timestamp > ago(1h) | count" в базе данных logs в кластере Azure Data Explorer "analytics-cluster".
  • Запрос данных: "Запустите запрос KQL 'логи | where Level == "Error" и Timestamp > ago(24h)', чтобы найти все ошибки за последние 24 часа в базе данных 'logs' в кластере ADX 'analytics-cluster'."
  • Получение данных: "Получите последние события с запросом 'События | выбор 100' из базы данных 'logs' в кластере Data Explorer 'analytics-cluster'."
  • Извлечение аналитических сведений: "Запрос шаблонов действий пользователей с помощью 'UserActivity | summarize count() by UserId' из базы данных 'logs' в кластере Azure Data Explorer analytics-cluster".
  • Анализ журналов: "Выполните запрос KQL 'Metrics | summarize avg(Duration) by Service', чтобы суммировать метрики производительности по службе в базе данных 'телеметрия' в кластере ADX 'analytics-cluster'."
Параметр Обязательно или необязательно Описание
URI кластера Условно обязательный Унифицированный идентификатор ресурса (URI) кластера Azure Data Explorer.
Гроздь Условно обязательный Имя кластера Azure Data Explorer.
База данных Обязательно Имя базы данных Azure Data Explorer.
Запрос Обязательно Запрос KQL для выполнения.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌