В этой статье приведены сведения о переносе содержимого из Power BI Embedded в службу Power BI и его внедрении в приложения с помощью расширенных функций.

Недавно корпорация Майкрософт объявила о выпуске Power BI Premium — новой модели лицензирования на основе емкости, которая повышает возможности получения доступа к содержимому, а также его совместного использования и распространения. Это предложение также обеспечивает дополнительные возможности масштабирования и повышает производительность службы Power BI.

С момента объявления выпуска Power BI Premium началось объединение служб Power BI Embedded и Power BI в одно решение, что позволит улучшить возможности внедрения содержимого Power BI в приложения. Это означает, что у вас будет одна область API, одинаковый набор возможностей и доступ к последним функциям Power BI, например информационным панелям, шлюзам и рабочим областям приложений, которые можно использовать при внедрении содержимого. В будущем вы сможете начать работу с Power BI Desktop, а затем обновить ее до решения Power BI Premium, общедоступная версия которого выйдет в конце второго квартала 2017 года.

Текущая служба Power BI Embedded будет доступна в течение ограниченного времени. Затем выйдет общедоступная версия объединенного решения. Пользователи с Соглашением Enterprise будут иметь доступ к Power BI Embedded до окончания срока действия этого соглашения, а пользователи, получившие эту службу через каналы CSP или прямые каналы, смогут использовать ее в течение одного года с момента выпуска общедоступной версии Power BI Premium. В этой статье приведены некоторые рекомендации по переносу из Azure в службу Power BI, а также сведения о возможных изменениях в приложении.

Важно!

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

Подготовка к переносу

Перед переносом содержимого из службы Power BI Embedded в Power BI необходимо выполнить несколько действий. Вам потребуется клиент, а также пользователь с лицензией Power BI Pro.

  1. Обеспечьте доступ к клиенту Azure Active Directory (Azure AD).

    Потребуется определить, какой вариант клиента следует использовать.

    • Использовать существующий корпоративной клиент Power BI?
    • Использовать отдельный клиент для приложения?
    • Использовать отдельный клиент для каждого пользователя?

    Если вы решили создать клиент для приложения или для каждого пользователя, ознакомьтесь с разделом Создание клиента Azure Active Directory или Получение клиента Azure Active Directory.

  2. Создайте в этом новом клиенте пользователя, который будет выполнять роль "главной" учетной записи приложения. Эту учетную запись необходимо зарегистрировать в Power BI и назначить ей лицензию Power BI Pro.

Учетные записи Azure AD

В клиенте должны использоваться следующие учетные записи.

Примечание.

Этим учетным записям потребуются лицензии Power BI Pro, чтобы использовать рабочие области приложений.

  1. Учетная запись администратора клиента.

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

  2. Учетные записи аналитиков, создающих содержимое.

    При необходимости этих пользователей следует добавить в рабочие области приложений.

  3. Главная учетная запись приложения, или учетная запись службы.

    Учетные данные этой учетной записи хранятся в серверной части приложений. Эта учетная запись используется для получения токена Azure AD, используемого в интерфейсах REST API Power BI, и создания токена внедрения приложения. Эта учетная запись также должна быть учетной записью администратора рабочих областей приложений, созданных для внедрения.

    Примечание.

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

Регистрация приложения и разрешения

Приложение необходимо зарегистрировать в Azure AD и предоставить ему определенные разрешения.

Регистрация приложения

Необходимо зарегистрировать приложение в Azure AD, чтобы осуществлять вызовы REST API. Для этого перейдите на портал Azure и примените дополнительные настройки в дополнение к действиям на странице регистрации приложения Power BI. Дополнительные сведения см. в статье Регистрация приложения Azure AD для внедрения содержимого Power BI.

Необходимо зарегистрировать приложение с использованием главной учетной записи приложения.

Создание рабочих областей приложения (обязательно)

Рабочие области приложений позволяют улучшить изоляцию, если приложение обслуживает несколько клиентов. Информационные панели и отчеты разных клиентов будут изолированы. Затем вы можете использовать учетную запись Power BI на каждую рабочую область приложения, что позволит еще больше изолировать приложение.

Важно!

Невозможно использовать личную рабочую область, чтобы внедрить содержимое для пользователей, не использующих Power BI.

Чтобы создать рабочую область приложения в Power BI, вам понадобится пользователь с лицензией Pro. Пользователь Power BI, который создает рабочую область приложения, по умолчанию назначается ее администратором.

Примечание.

Главная учетная запись приложения должна быть учетной записью администратора рабочей области.

Перенос содержимого

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

Вы можете использовать инструмент переноса, чтобы скопировать содержимое из Power BI Embedded в службу Power BI. Особенно если содержимого у вас много. Дополнительные сведения см. в статье Инструмент переноса Power BI Embedded.

Для переноса содержимого в основном используются два API.

  1. API скачивания PBIX-файлов. Он позволяет скачивать PBIX-файлы, которые были переданы в Power BI после октября 2016 года.
  2. API импорта PBIX-файлов. Он позволяет передать в Power BI любой PBIX-файл.

Соответствующие фрагменты кода приведены в разделе Фрагменты кода для переноса содержимого из Power BI Embedded.

Типы отчетов

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

Кэшированный набор данных и отчет

Кэшированные наборы данных — это PBIX-файлы, содержащие импортированные данные, в отличие от наборов данных с активным подключением или подключением DirectQuery.

Последовательность

  1. Вызовите API скачивания PBIX-файлов из рабочей области PaaS.
  2. Сохраните PBIX-файл.
  3. Вызовите API импорта PBIX-файлов в рабочей области SaaS.

Набор данных и отчет DirectQuery

Последовательность

  1. Выполните вызов GET https://api.powerbi.com/v1.0/collections/ {ИД_коллекции}/workspaces/{ИД_рабочей_области}/datasets/{ИД_набора_данных}/Default.GetBoundGatewayDataSources и сохраните полученную строку подключения.
  2. Вызовите API скачивания PBIX-файлов из рабочей области PaaS.
  3. Сохраните PBIX-файл.
  4. Вызовите API импорта PBIX-файлов в рабочей области SaaS.
  5. Обновите строку подключения, выполнив вызов POST https://api.powerbi.com/v1.0/myorg/datasets/ {ИД_набора_данных}/Default.SetAllConnections.
  6. Получите идентификаторы шлюза и источника данных, выполнив вызов GET https://api.powerbi.com/v1.0/myorg/datasets/{ИД_набора_данных}/Default.GetBoundGatewayDataSources.
  7. Обновите учетные данные пользователя, выполнив вызов PATCH https://api.powerbi.com/v1.0/myorg/gateways/{ИД_шлюза}/datasources/{ИД_источника_данных}.

Устаревшие наборы данных и отчеты

Это наборы данных и отчеты, созданные до октября 2016 года. API скачивания PBIX-файлов не поддерживает PBIX-файлы, которые были переданы до октября 2016 года.

Последовательность

  1. Получите PBIX-файл из своей среды разработки (внутренней системы управления версиями).
  2. Вызовите API импорта PBIX-файлов в рабочей области SaaS.

Отправка набора данных и отчета

API скачивания PBIX-файлов не поддерживает наборы данных API отправки. Данные из набора данных API невозможно перенести из PaaS в SaaS.

Последовательность

  1. Вызовите API "Создание набора данных" для набора данных JSON, чтобы создать набор данных в рабочей области SaaS.
  2. Повторно создайте отчет для созданного набора данных*.

Существуют обходные пути для переноса отчета API отправки из PaaS в SaaS. Они приведены ниже.

  1. Передайте фиктивный PBIX-файл в рабочую область PaaS.
  2. Клонируйте отчет API отправки и привяжите его к этому фиктивному PBIX-файлу.
  3. Скачайте отчет API отправки с фиктивным PBIX-файлом.
  4. Передайте фиктивный PBIX-файл в рабочую область SaaS.
  5. Создайте набор данных API отправки в рабочей области SaaS.
  6. Повторно создайте отчет для набора данных API отправки.

Создание отчетов и их передача

Помимо содержимого, переносимого из службы Azure Power BI Embedded, можно создавать отчеты и наборы данных с помощью Power BI Desktop, а затем публиковать эти отчеты в рабочей области приложения. У пользователя, публикующего отчеты в рабочей области приложения, должна быть лицензия Power BI Pro.

Повторное создание приложения

  1. Сначала вам потребуется изменить приложение, чтобы обеспечить доступ к интерфейсам REST API Power BI и расположению отчета на сайте powerbi.com.

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

  3. Внедрите отчеты из powerbi.com в приложение.

Сопоставления пользователей с пользователем Power BI

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

Перенос в рабочую среду

Когда вы будете готовы перенести содержимое в рабочую среду, сделайте следующее.

  • Если вы используете отдельный клиент для разработки, необходимо будет убедитесь, что рабочие области приложений, панели мониторинга и отчеты доступны в вашей рабочей среде. Также необходимо будет убедиться, что приложение создано в Azure AD для рабочего клиента и для этого приложения назначены соответствующие разрешения, как описано на шаге 1.

  • Приобретите необходимый размер емкости. Чтобы понять, что вам может понадобиться, вы можете ознакомиться с техническим документом по планированию емкости для внедренной аналитики. Когда вы будете готовы к покупке, вы сможете осуществить ее в Центре администрирования Office 365.

    Информация.

    Сведения о том, как приобрести Power BI Premium, см. в разделе Как купить Power BI Premium.

  • Измените рабочую область приложения и переместите ее в емкость Premium в диалоговом окне "Дополнительно".

  • Разверните обновленное приложение в рабочую среду и приступите к внедрению отчетов из службы Power BI.

Действия после переноса

После переноса необходимо сделать некоторые очистки в Azure.

  • Удалите все рабочие области развернутого решения в службе Azure Power BI Embedded.
  • Удалите все имеющиеся в Azure коллекции рабочей области.

Дальнейшие действия

Внедрение в Power BI
Инструмент переноса Power BI Embedded
Фрагменты кода для переноса содержимого из Power BI Embedded
Как внедрять панели мониторинга, отчеты и плитки Power BI
Что такое Power BI Premium?
Репозиторий Git JavaScript API
Репозиторий Git Power BI C#
Пример внедрения JavaScript
Технический документ по планированию емкости для внедренной аналитики
Техническая документация по Power BI Premium

Появились дополнительные вопросы? Попробуйте задать вопрос в сообществе Power BI.