Поделиться через


Запись запросов язык запросов Kusto в веб-интерфейсе Azure Data Explorer

Редактор запросов веб-интерфейса Azure Data Explorer предлагает различные функции, помогающие создавать запросы язык запросов Kusto (KQL). Некоторые из этих функций включают встроенную встроенную надстройку KQL Intellisense и автозавершение, встроенную документацию и всплывающие окна быстрого исправления. В этой статье мы рассмотрим, что следует знать при написании запросов KQL в пользовательском веб-интерфейсе.

KQL Intellisense и автозавершение

Редактор запросов имеет встроенную функцию KQL Intellisense, которая предлагает контекстные предложения для функций и операторов, а также автозавершение, которое завершает запросы для экономии времени и усилий.

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

  1. Начните вводить запрос в редакторе запросов.

  2. KQL Intellisense активирует, показыв раскрывающийся список для сущностей, операторов, функций и т. д. Переместите между этими параметрами с помощью клавиш со стрелками на клавиатуре и выберите один , нажав клавишу ВВОД или выбрав параметр с помощью мыши.

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

На снимке экрана показано, как работает intellisense и автозавершение.

Просмотр встроенной документации

Редактор запросов предоставляет встроенный доступ к документации для операторов KQL, функций и команд управления.

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

  1. Наведите указатель мыши на оператор, функцию или команду в Intellisense.

  2. Щелкните значок стрелки вправо, чтобы открыть встроенную предварительную версию документации.

    Снимок экрана: документация по встроенным операторам KQL.

    Примечание.

    Предварительная версия остается активной, пока не закроете его или завершите сеанс, даже для других операторов и функций.

  3. Если вы хотите открыть полную документацию в браузере, выберите просмотр в Интернете.

Быстрое исправление: предложение запроса или предупреждение

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

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

  1. Наведите указатель мыши на термин, чтобы просмотреть предложение или предупреждение.

  2. Выберите быстрое исправление , чтобы отобразить доступные параметры быстрого исправления.

  3. Выберите нужный вариант быстрого исправления.

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

Совет

Сведения о настройке предложений и предупреждений, которые вы получаете, см. в статье "Настройка параметров в веб-интерфейсе Azure Data Explorer".

Быстрое исправление. Извлечение значения в переменную

Функцию быстрого исправления можно также использовать для извлечения значения в переменную:

  1. Выберите значение для извлечения.

  2. Щелкните значок лампочки или нажмите клавиши CTRL+. Чтобы открыть параметры быстрого исправления.

  3. Выберите "Извлечь значение".

Снимок экрана: быстрое исправление для извлечения значения в переменную.

Быстрое исправление: определение встроенных функций

Функцию быстрого исправления можно также использовать для определения существующей встроенной функции перед его использованием. Добавление встроенного определения функции может оказаться полезным для повышения удобочитаемости и удобства обслуживания запросов.

Чтобы отобразить определение функции:

  1. Напишите и выберите имя функции.

  2. Щелкните значок лампочки или нажмите клавиши CTRL+. Чтобы открыть параметры быстрого исправления.

  3. Чтобы определить встроенную функцию, выберите Inline (встроенная функция) или Inline Recursive (встроенная функция).

Снимок экрана: функция быстрого исправления функции определения функции.

Использование средств KQL

Средства KQL на панели инструментов помогут быстро дублировать запрос, открыть палитру команд или документацию по доступу.

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

  1. На панели инструментов выберите средства KQL.

  2. Выберите варианты, такие как повторяющиеся запросы, открыть палитру команд или наведите указатель мыши на ресурсы для доступа к ссылкам документации. Этот список включает такие ресурсы, как KQL в памятку SQL, сочетания клавиш и справочная документация по KQL.

Снимок экрана: параметр средств KQL на панели инструментов веб-интерфейса.