Визуализация данных Azure Cosmos DB с помощью Power BI

ОБЛАСТЬ ПРИМЕНЕНИЯ: NoSQL

В этой статье описываются шаги, необходимые для подключения данных Azure Cosmos DB к Power BI Desktop.

Подключиться к Azure Cosmos DB из Power BI Desktop можно с помощью одного из следующих вариантов.

  • Используйте Azure Synapse Link, чтобы создавать отчеты Power BI без влияния на производительность и стоимость транзакционных рабочих нагрузок и без использования конвейеров извлечения, преобразования и загрузки.

    Можно использовать режим DirectQuery или режим импорта. С помощью DirectQuery можно создавать панели мониторинга или отчеты, используя динамические данные из учетных записей Azure Cosmos DB, не импортируя и не копируя эти данные в Power BI.

  • Подключите Power BI Desktop к учетной записи Azure Cosmos DB с помощью соединителя Azure Cosmos DB для Power BI. Этот вариант доступен только в режиме импорта и будет использовать ЕЗ, выделенные для транзакционных рабочих нагрузок.

Примечание.

Отчеты, созданные в Power BI Desktop, можно опубликовать на сайте PowerBI.com. Напрямую извлекать данные Azure Cosmos DB с PowerBI.com невозможно.

Необходимые компоненты

Перед выполнением инструкций в этом руководстве по Power BI убедитесь в наличии доступа к следующим ресурсам:

Для совместного использования отчетов в службе PowerBI.com необходимо настроить учетную запись в PowerBI.com. Дополнительные сведения о Power BI и Power BI Pro см. по ссылке https://powerbi.microsoft.com/pricing.

Начнем?

Вы можете включить Azure Synapse Link в существующих контейнерах Azure Cosmos DB и создать отчеты бизнес-аналитики на основе этих данных, используя портал Azure Cosmos DB. Power BI будет подключаться к Azure Cosmos DB с помощью режима Direct Query, что позволяет запрашивать динамические данные Azure Cosmos DB, не влияя на рабочие нагрузки транзакций.

Чтобы создать отчет или панель мониторинга Power BI, выполните приведенные ниже действия.

  1. Войдите на портал Azure и перейдите в учетную запись Azure Cosmos DB.

  2. В разделе Интеграции откройте панель Power BI и выберите Начало работы.

    Примечание.

    В настоящее время этот параметр доступен только для учетных записей API для NoSQL. Представления T-SQL можно создавать непосредственно в бессерверных пулах SQL Synapse и создавать панели мониторинга бизнес-аналитики для Azure Cosmos DB для MongoDB. Дополнительные сведения см. в статье Использование Power BI и бессерверного пула SQL Synapse для анализа данных Azure Cosmos DB с помощью Synapse.

  3. Включите функцию Synapse Link для учетной записи на вкладке Включение Azure Synapse Link в разделе Включение Azure Synapse Link для этой учетной записи. Если функция Synapse Link уже включена для учетной записи, эта вкладка отображаться не будет. Этот шаг является необходимым условием для включения Synapse Link в контейнерах.

    Примечание.

    Включение Azure Synapse Link повлияет на выставление счетов. Дополнительные сведения см. в разделе Цены на Azure Synapse Link.

  4. В разделе Включение Azure Synapse Link для контейнеров выберите контейнеры, для которых необходимо включить Synapse Link.

    • Если функция Synapse Link уже была включена для некоторых контейнеров, то флажок рядом с именем контейнера будет выбран. При желании можно снять необходимые флажки в зависимости от данных, которые вы хотите визуализировать в Power BI.

    • Если функция Synapse Link не включена, ее можно включить в существующих контейнерах.

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

    Progress of Synapse Link enabled on existing containers.

  5. В зависимости от объема данных в контейнерах на включение функции Synapse Link может потребоваться некоторое время. Дополнительные сведения см. в статье Включение Synapse Link в существующих контейнерах.

    Ход включения Synapse Link можно просмотреть на портале, как показано на следующем экране. Контейнеры включены с Synapse Link, когда ход выполнения достигает 100 %.

    Synapse Link successfully enabled on the selected containers.

  6. На вкладке Выбор рабочей области выберите рабочую область Azure Synapse Analytics и нажмите кнопку Далее. При этом в Synapse Analytics будут автоматически созданы представления T-SQL для контейнеров, выбранных ранее. Дополнительные сведения о представлениях T-SQL, необходимых для подключения Azure Cosmos DB к Power BI, см. в статье "Подготовка представлений ".

    Примечание.

    Ваши свойства контейнера Azure Cosmos DB будут представлены в виде столбцов в представлениях T-SQL, включая глубокие вложенные данные JSON. Это краткое руководство по созданию панелей мониторинга бизнес-аналитики. Эти представления будут доступны в рабочей области или базе данных Synapse. Вы также можете использовать эти же представления в рабочей области Synapse для изучения данных, обработки и анализа данных, инжиниринга данных и так далее. Обратите внимание, что в расширенных сценариях могут требоваться более сложные представления или тонкая настройка этих представлений для повышения производительности. Дополнительные сведения. См. рекомендации по Synapse Link при использовании бессерверных пулов Synapse SQL.

  7. Можно выбрать существующую рабочую область или создать новую. Чтобы выбрать существующую рабочую область, укажите сведения о Подписке, Рабочей области и Базе данных. портал Azure будет использовать учетные данные Microsoft Entra для автоматического подключения к рабочей области Synapse и создания представлений T-SQL. Убедитесь, что у вас есть разрешения администратора Synapse для этой рабочей области.

    Connect to Synapse Link workspace and create views.

  8. Затем выберите Скачать файл .pbids, чтобы скачать файл источника данных Power BI. Откройте загруженный файл. Он содержит необходимые сведения о подключении и открывает Power BI Desktop.

    Download the Power BI desktop files in .pbids format.

  9. Теперь вы можете подключаться к данным Azure Cosmos DB из Power BI Desktop. Отображается список представлений T-SQL, соответствующих данным в каждом контейнере.

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

    T-SQL views corresponding to the data in each container.

  10. Теперь вы можете приступить к созданию отчета с использованием аналитических данных Azure Cosmos DB. Все изменения, внесенные в данные, будут отражены в отчете, как только данные будут реплицированы в аналитическое хранилище (обычно это занимает несколько минут).

Создание отчетов бизнес-аналитики с помощью соединителя Power BI

Примечание.

Подключение в Azure Cosmos DB с соединителем Power BI в настоящее время поддерживается только для учетных записей Gremlin для Azure Cosmos DB для NoSQL и API для учетных записей Gremlin.

  1. Запустите Power BI Desktop.

  2. Непосредственно на экране приветствия можно получить данные, просмотреть последние источники или открыть другие отчеты. Щелкните значок X в правом верхнем углу, чтобы закрыть этот экран. Откроется представление Отчет средства Power BI Desktop.

    Power BI Desktop Report View - Power BI connector

  3. Откройте ленту Главная и щелкните Получить данные. Откроется окно Получение данных .

  4. Выберите Azure, затем — Azure Cosmos DB (бета-версия) и щелкните Подключить.

    Power BI Desktop Get Data - Power BI connector

  5. На странице Предварительная версия соединителя нажмите кнопку Продолжить. Откроется окно Azure Cosmos DB.

  6. Укажите URL-адрес конечной точки учетной записи Azure Cosmos DB, из которой необходимо получить данные, как показано ниже, и нажмите кнопку ОК. Чтобы использовать собственную учетную запись, можно найти URL-адрес в поле универсального кода ресурса (URI) в колонке Ключи на портале Azure. При необходимости можно задать имя базы данных, имя коллекции или использовать навигатор для выбора базы данных и коллекции, чтобы определить источник данных.

  7. При подключении к этой конечной точке в первый раз отображается запрос на введение ключа учетной записи. Для собственной учетной записи найдите ключ в поле Первичный ключ в колонке Ключи только для чтения на портале Azure. Введите соответствующий ключ и нажмите кнопку Подключить.

    При создании отчетов мы рекомендуем использовать ключ только для чтения. Это защитит первичный ключ от ненужных потенциальных угроз безопасности. Ключ только для чтения доступен в колонке Ключи на портале Azure.

  8. После успешного подключения учетной записи откроется панель Навигатор. На панели Навигатор отображается список баз данных в учетной записи.

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

    В области «Предварительный просмотр» отображается список элементов Запись . Документ представлен как тип Запись в Power BI. Точно так же вложенный блок JSON в документе является Записью. Чтобы просмотреть документы свойств в виде столбцов, нажмите серую кнопку со стрелками в противоположных направлениях, которые символизируют расширение записи. Она расположена справа от имени контейнера в той же области предварительного просмотра.

  10. Для создания отчетов, в которых наглядно представлены данные, используется представление отчета в Power BI Desktop. Отчеты можно создавать путем перетаскивания полей на поле Отчет .

  11. Существует два способа обновления данных — ситуативно и по расписанию. Чтобы обновить данные, просто щелкните Обновить. Дополнительные сведения о параметре запланированного обновления см. в документации по Power BI.

Следующие шаги