Share via

Написание запросов язык запросов 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. Чтобы определить встроенную функцию, выберите Встроенный (встроенная функция) или Встроенный рекурсивный (встроенная функция) .

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

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

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

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

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

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

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

См. также