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

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

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

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

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

Выбор базы данных

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

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

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

Взаимодействие с базами данных с помощью области подключения

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

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

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

• Обновление данных
• Просмотр профиля данных
• Вставка , чтобы создать скрипт и вставить его в редактор запросов
• Удаление

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

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

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

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

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

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

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

   

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

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

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

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

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

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

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

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

   

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

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

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

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

   Внимание

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

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

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

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

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

   

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

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

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

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

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

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

   

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