Визуализируйте данные из Azure Data Explorer в Redash

Redash подключает и запрашивает ваши источники данных, создает информационные панели для визуализации данных и обмена ими с коллегами. В этой статье вы узнаете, как настроить Azure Data Explorer в качестве источника данных для Redash, а затем визуализировать данные.

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

• Подписка Azure. Создайте бесплатную учетную запись Azure.
• Кластер и база данных Azure Data Explorer. Создайте кластер и базу данных.
• Получите данные, как описано в разделе вставка примеров данных в Azure Data Explorer. Дополнительные параметры приема см. в обзоре приема.

Настройка источника данных

Чтобы настроить Azure Data Explorer в качестве источника данных для инструмента информационной панели, выполните приведенные ниже действия. Мы подробнее рассмотрим эти действия далее в этом разделе.

1. Создайте субъект-службу Microsoft Entra. Субъект-служба используется инструментов информационной панели для доступа к службе Azure Data Explorer.

2. Добавьте субъект-службу Microsoft Entra в роль зрителей в базе данных azure Data Explorer.

3. Укажите свойства подключения к инструменту панели мониторинга на основе сведений от субъекта-службы Microsoft Entra, а затем проверьте подключение.

Создание субъекта-службы

Вы можете создать субъект-службу на портале Azure или с помощью интерфейса командной строки Azure CLI. Независимо от выбранного метода после создания вы получите значения для четырех свойств подключения, которые потребуются вам на последующих шагах.

Портал Azure

1. Чтобы создать субъект-службу, выполните инструкции, приведенные в документации по порталу Azure.

   1. В разделе Назначение приложению роли присвойте роль с типом Читатель используемому кластеру Azure Data Explorer.

   2. В разделе Получение значений для входа скопируйте три значения свойств, описанные в инструкциях: Идентификатор каталога (идентификатор клиента), Идентификатор приложения и Пароль.

2. На портале Azure выберите раздел Подписки и скопируйте идентификатор подписки, в которой вы создали субъект-службу.

   

Azure CLI

1. Создание субъекта-службы. Задайте нужную область и тип роли reader.

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Дополнительные сведения см. в статье Создание субъекта-службы Azure с помощью Azure CLI.

2. Эта команда возвращает результаты в показанном ниже формате. Скопируйте значения трех свойств: appID (идентификатор приложения), password (пароль) и tenant (арендатор).

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Получите список своих подписок.

   az account list --output table
   

   Скопируйте идентификатор соответствующей подписки.

   

Назначение субъекту-службе роли читателя

Назначьте созданному субъекту-службе роль читателя базы данных Azure Data Explorer. Это действие можно выполнить в разделе Разрешения на портале Azure или в разделе Запрос с помощью команды управления.

Портал Azure — разрешения

1. На портале Azure перейдите к кластеру Azure Data Explorer.

2. В разделе Обзор выберите базу данных с демонстрационными данными StormEvents.

   

3. Выберите Разрешения и щелкните Добавить.

   

4. В разделе Добавить разрешения базы данных выберите роль Читатель, а затем щелкните Select principals (Выбрать субъекты).

   

5. Найдите созданный субъект-службу. Установите флажок возле субъекта и нажмите кнопку Выбрать.

   

6. Щелкните Сохранить.

   

Команда управления — запрос

1. На портале Azure перейдите к кластеру Azure Data Explorer и выберите Запрос.

   

2. Выполните приведенную ниже команду в окне запроса. Используйте идентификаторы приложения и арендатора, полученные с помощью портала Azure или интерфейса командной строки.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   Эта команда возвращает результаты в показанном ниже формате. В этом примере первая строка обозначает существующего пользователя в базе данных, а вторая — только что добавленный субъект-службу.

   

Создание соединителя Azure Data Explorer в Redash

1. Войдите в Redash. Выберите Начало работы, чтобы создать учетную запись.

2. В разделе Начало работы выберите Подключить источник данных.

   

3. В окне Создание нового источника данных выберите Azure Data Explorer (Kusto) , затем выберите Создать.

   

4. В окне Azure Data Explorer (Kusto) заполните следующую форму и выберите Создать.

   

5. В окне Параметры выберите Сохранить и Проверить подключение, чтобы протестировать подключение к источнику данных Azure Data Explorer (Kusto) .

Создание запросов в Redash

1. В верхнем левом углу Redash, выберите Создать>Запрос. Щелкните Создать запрос и переименуйте запрос.

   

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

   

   На левой панели вы можете увидеть имя подключения к источнику данных (коннектор Github в нашем потоке) в раскрывающемся меню и таблицы в выбранной базе данных.

3. Просмотрите результаты запроса в нижней центральной панели. Создайте визуализацию в соответствии с запросом, нажав кнопку Новая визуализация.

   

4. На экране визуализации выберите Тип визуализации и соответствующие поля, такие как столбец X и столбец Y. Сохранить визуализацию.

   

Создать запрос с использованием параметра

1. Создать>Запрос для создания нового запроса. Добавьте к нему параметр, используя фигурные скобки {{}}. Выберите {{}} , чтобы открыть окно Добавить параметр. Вы также можете выбрать значок настроек, чтобы изменить атрибуты существующего параметра и открыть окно <parameter_name>.

   

2. Назовите свой параметр. В раскрывающемся меню выберите Тип: Раскрывающийся список на основе запроса. Нажмите кнопку ОК

   

   Примечание

   В запросе используется несколько значений, поэтому необходимо включить следующий синтаксис | where Type in ((split('{{Type}}', ','))). Для получения дополнительной информации см. Оператор in. Это приводит к нескольким вариантов параметров запроса в приложении redash

Создание информационной панели в Redash

1. Чтобы создать информационную панель, выберите Создать>Информационная панель. Либо выберите существующую панель мониторинга, Информационная панель> выберите панель мониторинга из списка.

   

2. В окне Новая информационная панель назовите панель управления и выберите Сохранить. В окне <Dashboard_name> выберите элемент Добавить мини-приложение, чтобы создать новое мини-приложение.

3. В окне Добавить виджет выберите имя запроса, Выбрать визуализацию и Параметры. Выберите Добавить в панель управления

   

4. Выберите Готово редактирование, чтобы завершить создание панели мониторинга.

5. В режиме редактирования панели мониторинга выберите Использовать фильтры уровня информационной панели, чтобы использовать ранее определенный параметр Тип.

   

См. также

• Написание запросов для обозревателя данных Azure