Узнайте, какие действия необходимо выполнить для внедрения содержимого 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.

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

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

Примечание.

В интерфейсах API Power BI рабочие области приложения по-прежнему называются группами. Если упоминаются группы, это означает, что вы работаете с рабочими областями приложения.

Шаг 1. Настройка среды разработки внедренной аналитики

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

Примечание.

Наличие Power BI Premium не является обязательным условием для разработки приложения. Разработчикам приложения потребуется лицензия Power BI Pro.

Клиент Azure Active Directory

Чтобы внедрить элементы из Power BI, потребуется клиент Azure Active Directory (Azure AD). У этого клиента должен быть по крайней мере один пользователь Power BI Pro. Также будет необходимо определить приложение Azure AD в данном клиенте. Можно использовать существующий клиент Azure AD или создать новый клиент специально для внедрения.

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

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

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

Создание учетной записи Power BI Pro

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

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

Администратор организации или клиента

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

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

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

Главная учетная запись для пользователей, не использующих Power BI

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

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

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

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

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

Если вы внедряете панели мониторинга и отчеты для пользователей, не работающих с Power BI (данные принадлежат приложению), нужно поместить эти панели мониторинга и отчеты в рабочую область приложения. Сведения о том, как создать рабочую область приложения, см. в разделе Создание рабочей области приложения.

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

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

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

Шаг 2. Внедрение содержимого

В приложении потребуется пройти аутентификацию в Power BI. В случае внедрения содержимого для пользователей, не использующих Power BI, для этого потребуется сохранить в приложении учетные данные главной учетной записи. Дополнительные сведения см. в статье Authenticate users and get an Azure AD access token for your Power BI app (Проверка подлинности для пользователей и получение маркера доступа Azure AD для приложения Power BI).

После проверки подлинности в приложении используйте Power BI и API JavaScript для внедрения панелей мониторинга и отчетов в свое приложение.

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

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

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

Шаг 3. Перенос решения в рабочую среду

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

Пользователи Power BI (данные принадлежат пользователю)

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

Пользователи бесплатной службы могут использовать содержимое, которое внедрено из группы (рабочей области приложения), если эта рабочая область поддерживается емкостью Premium. Пользователь бесплатной службы должен быть указан как член группы (рабочей области приложения), иначе вы получите сообщение об ошибке авторизации 401.

Пользователи, не работающие с Power BI (данные принадлежат приложению)

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

  • Если вы можете использовать клиент для рабочей среды организации, то рекомендуется создать новую среду внедренной аналитики для рабочей среды. Чтобы получить дополнительные сведения, ознакомьтесь с шагом 1 выше.

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

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

Узел емкости Общее число ядер
(серверная часть и интерфейс)
Внутренние ядра Интерфейсные ядра Ограничения для подключений DirectQuery и активных подключений Максимальное число страниц, отображаемых в часы максимальной нагрузки
EM1 1 виртуальное ядро 0,5 ядра, 3 ГБ ОЗУ 0,5 ядра 1–300
EM2 2 виртуальных ядра 1 ядро, 5 ГБ ОЗУ 1 ядро 301–600
EM3 4 виртуальных ядра 2 ядра, 10 ГБ ОЗУ 2 ядра 601–1200
P1 8 виртуальных ядер 4 ядра, 25 ГБ ОЗУ 4 ядра 30 в секунду 1201–2400
P2 16 виртуальных ядер 8 ядер, 50 ГБ ОЗУ 8 ядер 60 в секунду 2401–4800
P3 32 виртуальных ядра 16 ядер, 100 ГБ ОЗУ 16 ядер 120 в секунду 4801–9600
Примечание.

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

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

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

Параметры администрирования

Глобальные администраторы или администраторы служб Power BI могут включать и отключать возможность использования REST API. Администраторы могут задать этот параметр для всей организации или для отдельных групп безопасности. По умолчанию установлено состояние "Включено для всей организации". Параметр задается на портале администрирования Power BI.

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

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

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