Запрос данных в наборе запросов KQL

Из этой статьи вы узнаете, как использовать набор запросов KQL. Набор запросов KQL позволяет выполнять запросы, просматривать результаты и настраивать результаты запросов для данных из разных источников, таких как хранилище событий или база данных KQL.

Можно также использовать набор запросов KQL для выполнения межсервисных запросов к рабочей области Log Analytics в Azure Monitor или ресурсу Application Insights.

Набор запросов KQL использует язык запросов Kusto (KQL) для создания запросов, а также поддерживает множество функций SQL. Дополнительные сведения о языке запросов см. в разделе Обзор языка запросов Kusto.

Требования

Выбор источника данных

Запросы выполняются в контексте источника данных. Связанный источник данных можно изменить в любое время и сохранить запросы в редакторе запросов. Набор запросов KQL можно связать с несколькими типами источников данных, включая базу данных KQL, кластер Azure Data Explorer или Azure Monitor.

Выберите вкладку для типа источника данных.

  1. Откройте набор запросов KQL.

  2. В области обозревателя под строкой поиска откройте переключатель базы данных и выберите Добавить источник данных>Eventhouse / База данных KQL.

    снимок экрана меню источника данных с списком подключенных источников данных.

  3. В окне каталога OneLake выберите базу данных KQL, чтобы подключиться к набору запросов KQL, а затем нажмите кнопку Connect.

    Кроме того, закройте окно каталога OneLake и используйте меню "+ Добавить источник данных " для подключения к другому источнику данных.

Список таблиц, связанных с этим источником данных, отображается под именем источника данных.

Напишите запрос

Теперь, когда вы подключены к источнику данных, вы можете выполнять запросы к нему. Набор запросов KQL использует язык запросов Kusto (KQL) для запроса данных из любого подключенного источника данных, к которому можно получить доступ. Дополнительные сведения о KQL см. в обзоре языка запросов Kusto.

В следующих примерах используется общедоступный StormEvents.csv пример файла.

  1. Напишите или скопируйте запрос в верхней области набора запросов KQL.

  2. Нажмите кнопку "Выполнить" или нажмите клавишу SHIFT+ВВОД, чтобы запустить запрос.

    Результаты запроса отображаются в сетке результатов под областью запроса. Обратите внимание на зеленую проверку, указывающую на успешное завершение запроса и время, используемое для вычисления результатов запроса.

    Снимок экрана: набор запросов KQL с результатами запроса. Выделены запрос и область результатов.

Замечание

Вы также можете использовать Copilot для написания запросов. Дополнительные сведения см. в статье Copilot для создания запросов в наборе запросов KQL.

Взаимодействие с источниками данных

Обозреватель источников данных позволяет переключаться между источниками данных, подключенными к текущей вкладке набора запросов.

В верхней части области обозревателя источников данных в разделе "Обозреватель" можно использовать строку поиска для поиска определенного источника данных. Вы также можете использовать переключатель базы данных под строкой поиска, чтобы развернуть меню подключений к источнику данных. Выберите источник данных, который требуется использовать. Если вы не переименовывали вкладку ранее, она автоматически называется источником данных.

снимок экрана, показывающий, как переключаться между источниками данных с помощью панели поиска и переключателя базы данных в области обозревателя.

Панель обозревателя источников данных содержит два раздела. В верхнем разделе перечислены все элементы в источнике данных, а в нижнем разделе показаны все доступные источники данных в наборе запросов.

Просмотр элементов в источнике данных

В верхнем разделе обозревателя источников данных отображаются все элементы в источнике данных, который вы используете.

  • Таблицы
  • Материализованные представления
  • Ярлыки
  • Функции

Щелкните стрелку > слева от элемента, который требуется развернуть. Чтобы просмотреть дополнительные сведения, щелкните стрелку > слева от элементов в последующих уровнях списка. Например, в разделе "Таблицы" щелкните стрелку > слева от таблицы, чтобы отобразить список столбцов в этой таблице.

Чтобы открыть меню действий, наведите указатель мыши на элемент в развернутом списке и выберите пункт "Дополнительно " [...]. Меню включает следующие параметры:

  • Обновление базы данных
  • Просмотр профиля данных
  • Изучение данных
  • Вставка — создание и копирование скрипта
  • Получение данных: добавление нового источника данных
  • Создание панели мониторинга
  • Удаление таблицы

Различные действия доступны для разных типов элементов.

снимок экрана с областью обозревателя, как развернуть список элементов в источнике данных и где найти меню

Просмотр доступных источников данных

В нижнем разделе обозревателя источников данных отображаются все доступные источники данных, добавляемые в набор запросов.

Чтобы открыть меню действий, наведите указатель мыши на имя источника данных и выберите меню "Дополнительно " [...]. Меню включает следующие параметры:

  • Обновление базы данных
  • Используйте эту базу данных: переключитесь на использование этого источника данных на текущей вкладке
  • Запрос на новой вкладке: откройте этот источник данных на новой вкладке в наборе запросов
  • Удаление источника: удаляет все базы данных в этом источнике данных
  • Удаление базы данных: удаляет только выбранную базу данных.
  • Откройте базу данных KQL: открывает этот источник данных в базе данных KQL.

Снимок экрана: нижний раздел области обозревателя, где перечислены все источники данных, добавленные в набор запросов.

Управление вкладками набора запросов

В наборе запросов KQL можно создать несколько вкладок. Каждая вкладка может быть связана с другой базой данных KQL. Эта настройка позволяет сохранять запросы для последующего использования или совместного использования с другими пользователями для совместной работы с исследованием данных. Вы также можете изменить базу данных KQL, связанную с любой вкладкой, которая позволяет выполнять один и тот же запрос на данные в разных базах данных.

Вы можете управлять вкладками следующими способами:

  • Изменение существующего подключения к источнику данных: в разделе обозревателя и панели поиска используйте переключатель базы данных, чтобы развернуть меню подключений к источнику данных.
  • Переименовать вкладку: рядом с именем вкладки выберите значок карандаша.
  • Добавить новую вкладку: справа от существующих вкладок на панели команд выберите плюс +. Различные вкладки можно подключить к разным источникам данных.
  • Дополнительные действия. В правой части панели команд используйте меню вкладок для управления несколькими вкладками в наборе запросов.
  • изменение позиций вкладок: используйте жесты перетаскивания.

Снимок экрана: меню нескольких вкладок для управления несколькими вкладками в наборе запросов KQL.

Удалить набор запросов KQL

Чтобы удалить набор запросов KQL, выполните приведенные действия.

  1. Выберите рабочую область, содержащую набор запросов KQL.

  2. Наведите указатель мыши на набор запросов KQL, который требуется удалить. Выберите еще [...], а затем нажмите кнопку "Удалить".

    Снимок экрана: рабочая область Microsoft Fabric, показывающая, как удалить набор запросов KQL.

Следующий шаг