Краткое руководство. Выполнение запросов к примерам данных в веб-интерфейсе Azure Data Explorer

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

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

В этом кратком руководстве вы:

  • Добавьте подключение к кластеру.
  • Выполняйте запросы KQL на образце данных.
  • Форматирование запроса и отрисовка диаграммы.
  • Предоставьте отзывы и очистите ресурсы.

Предварительные требования

Перед началом работы убедитесь, что у вас есть следующие элементы:

Добавление кластеров

При первом открытии веб-интерфейса на странице запроса вы увидите подключение к кластеру справки . В примерах этого краткого руководства используется таблица StormEvents в базе данных Samples кластера help.

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

  1. В меню слева выберите Запрос.
  2. В левой верхней области нажмите кнопку "Добавить подключение".
  3. В диалоговом окне "Добавление подключения" введите URI подключения кластера и отображаемое имя.
  4. Нажмите кнопку "Добавить ", чтобы добавить подключение.

Если кластер help не отображается, добавьте его, выполнив предыдущие шаги, и введите help в поле Connection URI.

Выполнение запроса

Чтобы запустить запрос, выберите базу данных, в которой нужно запустить запрос, чтобы задать контекст запроса.

  1. В области Подключение кластера в кластере help выберите базу данных Samples. Снимок экрана: выбранная база данных Samples.

  2. Копируйте и вставьте в окно запроса следующий запрос. Вверху окна выберите Выполнить.

    StormEvents
    | sort by StartTime desc
    | take 10
    

    Этот запрос возвращает десять последних записей в таблице StormEvents. В результате должно отобразиться что-то вроде следующей таблицы.

    Снимок экрана: таблица, в которую перечислены данные для 10 событий шторма в веб-интерфейсе Azure Data Explorer.

  3. Копируйте и вставьте в окно запроса под первым запросом следующий запрос. Обратите внимание, что это не отформатировано в виде отдельных строк, как в первом запросе.

    StormEvents | sort by StartTime desc 
    | project StartTime, EndTime, State, EventType, DamageProperty, EpisodeNarrative | take 10
    
  4. Выберите новый запрос. Нажмите клавиши SHIFT+ALT+F , чтобы отформатировать запрос, чтобы он выглядел следующим образом.

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

  5. Выберите Run или нажмите Shift+Enter, чтобы запустить запрос. Этот запрос возвращает те же записи, что и первый, но включает только столбцы, указанные в инструкции project. В результате должно отобразиться что-то вроде следующей таблицы.

    Снимок экрана таблицы, в котором перечислены время начала, время окончания, состояние, тип события, свойство повреждения и повествование эпизода для 10 событий шторма в веб-интерфейсе Azure Data Explorer.

    Совет

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

  6. Выполните еще один запрос, чтобы просмотреть другой тип выходных данных.

    StormEvents
    | summarize event_count=count(), mid = avg(BeginLat) by State
    | sort by mid
    | where event_count > 1800
    | project State, event_count
    | render columnchart
    

    Результат должен напоминать следующую схему.

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

    Примечание.

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

    • Если вы не выбираете текст, предполагается, что запрос или команда разделены пустыми строками.
    • При выборе текста выполняется выделенный текст.

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

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

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

Очистка ресурсов

Вы не создали никаких ресурсов в этом кратком руководстве. Чтобы удалить один или оба кластера из приложения, щелкните кластер правой кнопкой мыши и выберите "Удалить подключение". Другой вариант — выбрать "Очистить локальное состояние" на вкладке "Общие параметры>". Это действие удаляет все подключения к кластеру и закрывает все открытые вкладки запросов.