Создание и запуск записной книжки Kusto (KQL) (предварительная версия)

В этой статье показано, как создать и запустить записную книжку Azure Data Studio с помощью расширения Kusto (KQL), подключившись к кластеру Azure Data Explorer.

С помощью расширения Kusto (KQL) можно изменить параметр ядра на Kusto.

Эта функция в настоящее время находится на стадии предварительной версии.

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

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

Создание записной книжки Kusto (KQL)

Выполните следующие действия, чтобы создать файл записной книжки в Azure Data Studio:

  1. В Azure Data Studio подключитесь к кластеру Azure Data Explorer.

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

    Open notebook

  3. В качестве ядра выберите Kusto. Убедитесь, что в меню Подключиться к задано имя кластера и база данных. В этой статье мы используем кластер help.kusto.windows.net с данными базы данных Samples.

    Set Kernel and Attach to

Вы можете сохранить записную книжку с помощью команды Сохранить или Сохранить как... в меню Файл.

Чтобы открыть записную книжку, можно использовать команду Open file... в меню "Файл ", выбрать "Открыть файл " на странице приветствия или использовать команду "Файл: открыть " в палитре команд.

Изменение подключения

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

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

    change connections

    Примечание.

    Убедитесь, что поле базы данных заполнено. Для записных книжек Kusto требуется указать базу данных.

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

    Select a different cluster

    Примечание.

    Укажите имя кластера без https://.

Выполнение ячейки кода

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

Например:

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

    Kusto kernel code block

  2. Скопируйте приведенный ниже пример, вставьте его в ячейку и нажмите Выполнить ячейку. Этот пример запрашивает данные StormEvents для определенного типа события.

     StormEvents
     | where EventType == "Waterspout"
    

    Run cell

Сохранение результата или отображение диаграммы

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

  • Сохранить в формате CSV
  • Сохранить в формате Excel
  • Сохранить в формате JSON
  • Сохранить в формате XML
  • Показать диаграмму
    StormEvents
    | limit 10

Save result

Предоставление отзыва

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

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

Дополнительные сведения о записных книжках: