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

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

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

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

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

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

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

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

База данных KQL

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

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

   

3. В разделе Подключение источник выберите Концентратор данных OneLake.

4. В появившемся окне концентратора данных OneLake выберите базу данных KQL и нажмите кнопку "Выбрать".

   

Кластер Azure Data Explorer

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

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

   

3. В разделе Подключение источник выберите Azure Data Обозреватель.

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

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

   

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

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

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

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

Теперь, когда вы подключены к источнику данных, вы можете выполнять запросы к этим данным. Набор запросов 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.

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

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

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

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

   

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

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

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

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

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

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

   

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

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