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

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

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

Необходимые компоненты

• Рабочая область с емкостью с поддержкой Microsoft Fabric
• База данных KQL с разрешениями на редактирование и данными или кластером и базой данных Azure Data Explorer с разрешениями AllDatabaseAdmin.

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

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

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

База данных KQL

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

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

   

3. Выберите Добавить источник данных, а затем выберите Концентратор данных OneLake.

4. В появившемся окне концентратора данных OneLake выберите базу данных KQL, чтобы подключиться к набору запросов KQL, а затем нажмите кнопку Connect. Кроме того, закройте окно концентратора данных OneLake используйте меню + Добавление источника данных для подключения к другому источнику данных.

Кластер Azure Data Explorer

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

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

   

3. Выберите Добавить источник данных, а затем выберите Azure Data Explorer.

4. В разделе URI подключения введите универсальный код ресурса (URI) кластера.

   Чтобы найти URI подключения, перейдите к ресурсу кластера в портал Azure. Универсальный код ресурса (URI) подключения — это универсальный код ресурса (URI), найденный в обзоре. Чтобы добавить бесплатный пример кластера, укажите "help" в качестве URI подключения.

   

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

6. Нажмите Подключиться.

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

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

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

В следующих примерах используются данные, доступные в общедоступном режиме https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

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

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

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

   

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

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

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

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

Элементы в источнике данных

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

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

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

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

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

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

Доступные источники данных

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

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

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

Копировать запрос

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

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

2. В области запросов выберите "Копировать запрос".

   

   В следующей таблице описано множество параметров копирования запроса.

   Действие	Description
   Копировать запрос	Скопируйте текст запроса.
   Link to clipboard (Копировать ссылку);	Скопируйте глубокую ссылку, которую можно использовать для выполнения запроса.
   Связывание и запрос к буферу обмена	Скопируйте ссылку, которую можно использовать для выполнения запроса и текста запроса.
   Ссылка, запрос и результаты в буфер обмена	Скопируйте ссылку, которую можно использовать для выполнения запроса, текста запроса и результатов запроса.
   Копирование результатов	Скопируйте результаты запроса.

3. Выберите нужное действие из списка.

4. Вставьте эти сведения для изменения или совместного использования, например в Microsoft Word, Microsoft Teams или Outlook.

   Внимание

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

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

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

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

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

Экспорт данных запроса в формате CSV

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

Это одноразовый метод экспорта CSV-файла, содержащего результаты запроса.

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

   

2. В области запросов выберите "Экспорт в CSV".

3. Сохраните CSV-файл локально.

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

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

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

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

   

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

Настройка результатов в сетке результатов набора запросов KQL