Краткое руководство. Запрос примеров данных

  • Статья

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

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

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

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

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

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

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

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

Если вы не видите кластер справки , добавьте его, выполнив предыдущие действия. Используйте help в качестве URI подключения.

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

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

  1. В области Подключение кластера в кластере help выберите базу данных 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. Щелкните элемент Выполнить или нажмите клавиши SHIFT+ВВОД, чтобы выполнить запрос. Этот запрос возвращает те же записи, что и первый, но включает только столбцы, указанные в инструкции 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. Введите свой отзыв, а затем выберите Отправить.

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

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

См. также