Как перенести содержимое коллекции рабочих областей Power BI в Power BI EmbeddedHow to migrate Power BI Workspace Collection content to Power BI Embedded

Эта статья содержит сведения о переносе содержимого из коллекции рабочих областей Power BI в Power BI Embedded и его внедрении в приложения с помощью расширенных функций.Learn how to migrate from Power BI Workspace Collection to Power BI Embedded and leverage advances for embedding in apps.

Недавно корпорация Майкрософт объявила о выпуске Power BI Embedded — новой модели лицензирования на основе емкости, которая повышает гибкость доступа к содержимому, а также его совместного использования и распространения.Microsoft recently announced Power BI Embedded, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. Это предложение также обеспечивает дополнительные возможности масштабирования и повышает производительность.The offering also delivers additional scalability and performance.

Благодаря Power BI Embedded у вас будет одна область API, одинаковый набор возможностей и доступ к последним функциям Power BI, например панелям мониторинга, шлюзам и рабочим областям приложений, которые можно использовать при внедрении содержимого.With Power BI Embedded, you will have one API surface, a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding your content. В будущем вы сможете начать работу с Power BI Desktop, а затем обновить ее до версии Power BI Embedded.Moving forward you’ll be able to start with Power BI Desktop and move to deployment with Power BI Embedded.

Текущая коллекция рабочих областей Power BI будет доступна в течение ограниченного времени.The current Power BI Workspace Collection will continue to be available for a limited time. Пользователи с Соглашением Enterprise сохранят доступ до окончания срока действия этого соглашения, а пользователи, получившие эту коллекцию рабочих областей Power BI через каналы CSP или прямые каналы, смогут использовать ее в течение одного года с момента выпуска общедоступной версии Power BI Embedded.Customers under an Enterprise Agreement will have access through the expiration of their existing agreements; customers that acquired Power BI Workspace Collection through Direct or CSP channels will maintain access for one year from the General Availability release of Power BI Embedded. В этой статье приведены некоторые рекомендации по миграции из коллекции рабочих областей Power BI на Power BI Embedded, а также сведения о возможных изменениях в приложении.This article will provide some guidance for migrating from Power BI Workspace Collection to the new Power BI Embedded experience and what to expect for changes in your application.

Важно!

Процесс миграции зависит от Power BI Embedded. Но при использовании токена внедрения эта зависимость устраняется для пользователей вашего приложения.While the migration will take a dependency on Power BI Embedded, there is not a dependency on Power BI for the users of your application when using an embed token. Чтобы просмотреть содержимое приложения, пользователям не нужно регистрироваться в службе Power BI.They do not need to sign up for Power BI to view the embedded content in your application. Этот способ внедрения можно использовать для обслуживания пользователей, не использующих Power BI Embedded.You can use this embedding approach to Embedded non-Power BI users.

Процесс внедрения

Перед началом миграции в новую службу Power BI Embedded можно быстро ознакомиться с пошаговым руководством, которое поможет вам настроить новую среду Power BI Embedded с помощью средства настройки внедрения.Before you get started migrating to the new Power BI Embedded, you can quickly go through a walkthrough that helps you set up your new Power BI Embedded environment using the Embedding setup tool.

Выберите подходящее решение:Choose the solution that is right for you:

Подготовка к переносуPrepare for the migration

Перед переносом содержимого из коллекции рабочих областей Power BI в Power BI Embedded нужно выполнить несколько действий.There are a few things you need to do to prepare for migrating from Power BI Workspace Collection to Power BI Embedded. Вам потребуется клиент, а также пользователь с лицензией Power BI Pro.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Обеспечьте доступ к клиенту Azure Active Directory (Azure AD).Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    Нужно определить, какой вариант клиента использовать.You need to determine which tenant setup to use.

  2. Создайте в этом новом клиенте пользователя, который будет выполнять роль "главной" учетной записи приложения.Create a user within this new tenant that will act as your application "master" account. Эту учетную запись необходимо зарегистрировать в Power BI и назначить ей лицензию Power BI Pro.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

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

В клиенте должны использоваться следующие учетные записи.The following accounts will need to exist within your tenant.

Примечание

Этим учетным записям потребуются лицензии Power BI Pro, чтобы использовать рабочие области приложений.These accounts will need to have Power BI Pro licenses in order to use App workspaces.

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

    Мы советуем, чтобы этот пользователь был участником всех рабочих областей приложений, созданных для внедрения.It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

  2. Учетные записи аналитиков, создающих содержимое.Accounts for analysts that will create content.

    При необходимости этих пользователей следует добавить в рабочие области приложений.These users should be assigned to App workspaces as needed.

  3. Главная учетная запись приложения или учетная запись Embedded.An application master user account, or Embedded account.

    Учетные данные этой учетной записи хранятся в серверной части приложений. Эта учетная запись используется для получения токена Azure AD, используемого в интерфейсах REST API Power BI,The applications backend will store the credentials for this account and use it for acquiring an Azure AD token for use with the Power BI REST APIs. и создания токена внедрения приложения.This account will be used to generate the embed token for the application. Эта учетная запись также должна быть учетной записью администратора рабочих областей приложений, созданных для внедрения.This account also needs to be an admin of the App workspaces created for embedding.

Примечание

Это обычная корпоративная учетная запись пользователя, которая будет использоваться для внедрения.This is just a regular user account in your organization that will be used for the purposes of embedding.

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

Приложение необходимо зарегистрировать в Azure AD и предоставить ему определенные разрешения.You will need to register an application within Azure AD and grant certain permissions.

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

Необходимо зарегистрировать приложение в Azure AD, чтобы осуществлять вызовы REST API.You will need to register your application with Azure AD in order to make REST API calls. Для этого перейдите на портал Azure и примените дополнительные настройки в дополнение к действиям на странице регистрации приложения Power BI.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. Дополнительные сведения см. в статье Регистрация приложения Azure AD для внедрения содержимого Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Необходимо зарегистрировать приложение с использованием главной учетной записи приложения.You should register the application using the application master account.

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

Рабочие области приложений позволяют улучшить изоляцию, если приложение обслуживает несколько клиентов.You can take advantage of App workspaces to provide better isolation if your application is servicing multiple customers. Информационные панели и отчеты разных клиентов будут изолированы.Dashboards and reports would be isolated between your customers. Затем вы можете использовать учетную запись Power BI на каждую рабочую область приложения, что позволит еще больше изолировать приложение.You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

Важно!

Невозможно использовать личную рабочую область, чтобы внедрить содержимое для пользователей, не использующих Power BI.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Чтобы создать рабочую область приложения в Power BI, вам понадобится пользователь с лицензией Pro.You will need a user that has a Pro license in order to create an app workspace within Power BI. Пользователь Power BI, который создает рабочую область приложения, по умолчанию назначается ее администратором.The Power BI user that creates the App workspace will be an admin of that workspace by default.

Примечание

Главная учетная запись приложения должна быть учетной записью администратора рабочей области.The application master account needs to be an admin of the workspace.

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

Перенос содержимого из коллекций рабочих областей в Power BI Embedded может выполняться во время работы с текущим решением, не вызывая простоев.Migrating your content from your workspace collections to Power BI Embedded can be done in parallel to your current solution and doesn’t require any downtime.

Вы можете использовать средство миграции, чтобы скопировать содержимое из коллекции рабочих областей Power BI в Power BI Embedded.A migration tool is available for you to use in order to assist with copying content from Power BI Workspace Collection to Power BI Embedded. Особенно если содержимого у вас много.Especially if you have a lot of content. Дополнительные сведения см. в статье Инструмент переноса Power BI Embedded.For more information, see Power BI Embedded migration tool.

Для переноса содержимого в основном используются два API.Content migration relies mainly on two APIs.

  1. API скачивания PBIX-файлов. Он позволяет скачивать PBIX-файлы, которые были переданы в Power BI после октября 2016 года.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. API импорта PBIX-файлов. Он позволяет передать в Power BI любой PBIX-файл.Import PBIX - this API uploads any PBIX to Power BI.

Соответствующие фрагменты кода приведены в разделе Фрагменты кода для переноса содержимого из коллекции рабочих областей Power BI.For some related code snippets, see Code snippets for migrating content from Power BI Workspace Collection.

Типы отчетовReport types

Существует несколько типов отчетов, предназначенных для различных потоков переноса.There are several types of reports, each requiring a somewhat different migration flow.

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

Кэшированные наборы данных — это PBIX-файлы, содержащие импортированные данные, в отличие от наборов данных с активным подключением или подключением DirectQuery.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

ПотокFlow

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

Набор данных и отчет DirectQueryDirectQuery dataset & report

ПотокFlow

  1. Вызовите GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources и сохраните полученную строку подключения.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. Вызовите API скачивания PBIX-файлов из рабочей области PaaS.Call Download PBIX API from PaaS workspace.
  3. Сохраните PBIX-файл.Save PBIX.
  4. Вызовите API импорта PBIX-файлов в рабочей области SaaS.Call Import PBIX to SaaS workspace.
  5. Обновите строку подключения, вызвав POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections.Update connection string by calling - POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections
  6. Получите идентификаторы GW и источника данных, вызвав — получение https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSourcesGet GW and datasource identifiers by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. Обновите учетные данные пользователя, вызвав PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}.Update user's credentials by calling - PATCH https://api.powerbi.com/v1.0/myorg/gateways/{gateway_id}/datasources/{datasource_id}

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

Это наборы данных и отчеты, созданные до октября 2016 года.These are datasets/reports created before October 2016. API скачивания PBIX-файлов не поддерживает PBIX-файлы, которые были переданы до октября 2016 года.Download PBIX doesn't support PBIXs which were uploaded before October 2016

ПотокFlow

  1. Получите PBIX-файл из своей среды разработки (внутренней системы управления версиями).Get PBIX from your development environment (your internal source control).
  2. Вызовите API импорта PBIX-файлов в рабочей области SaaS.Call Import PBIX to SaaS workspace.

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

API скачивания PBIX-файлов не поддерживает наборы данных API отправки.Download PBIX doesn't support Push API datasets. Данные из набора данных API невозможно перенести из PaaS в SaaS.Push API dataset data can't be ported from PaaS to SaaS.

ПотокFlow

  1. Вызовите API "Создание набора данных" для набора данных JSON, чтобы создать набор данных в рабочей области SaaS.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. Повторно создайте отчет для созданного набора данных*.Rebuild report for the created dataset*.

Существуют обходные пути для переноса отчета API отправки из PaaS в SaaS. Они приведены ниже.It is possible, using some workarounds, to migrate the push api report from PaaS to SaaS by trying the following.

  1. Передайте фиктивный PBIX-файл в рабочую область PaaS.Uploading some dummy PBIX to PaaS workspace.
  2. Клонируйте отчет API отправки и привяжите его к этому фиктивному PBIX-файлу.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. Скачайте отчет API отправки с фиктивным PBIX-файлом.Download push API report with the dummy PBIX.
  4. Передайте фиктивный PBIX-файл в рабочую область SaaS.Upload dummy PBIX to your SaaS workspace.
  5. Создайте набор данных API отправки в рабочей области SaaS.Create push dataset in your SaaS workspace.
  6. Повторно создайте отчет для набора данных API отправки.Rebind report to push api dataset.

Создание отчетов и их передачаCreate and upload new reports

Помимо содержимого, переносимого из коллекции рабочих областей Power BI, можно создавать отчеты и наборы данных с помощью Power BI Desktop, а затем публиковать эти отчеты в рабочей области приложения.In addition to the content you migrated from the Power BI Workspace Collection, you can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. У пользователя, публикующего отчеты в рабочей области приложения, должна быть лицензия Power BI Pro.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

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

  1. Сначала вам потребуется изменить приложение, чтобы обеспечить доступ к интерфейсам REST API Power BI и расположению отчета на сайте powerbi.com.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. Перестройте параметры проверки подлинности AuthN и AuthZ с помощью главной учетной записи приложения.Rebuild your AuthN/AuthZ authentication using the master account for your application. Вы можете воспользоваться токеном внедрения, чтобы позволить этому пользователю действовать от имени других пользователей.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Внедрите отчеты из powerbi.com в приложение.Embed your reports from powerbi.com into your application.

Сопоставления пользователей с пользователем Power BIMap your users to a Power BI user

Пользователей, управление которыми выполняется в приложении, необходимо сопоставить с главными учетными данными Power BI.Within your application, you will map users that you manage within the application to a master Power BI credential for the purposes of your application. Учетные данные этой главной учетной записи Power BI хранятся в приложении и предназначены для создания токена внедрения.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

Перенос в рабочую средуWhat to do when you are ready for production

Когда вы будете готовы перенести содержимое в рабочую среду, сделайте следующее.When you are ready to move to production, you will need to do the following.

  • Если вы используете отдельный клиент для разработки, необходимо будет убедитесь, что рабочие области приложений, панели мониторинга и отчеты доступны в вашей рабочей среде.If you are using a separate tenant for development, then you will need to make sure your app workspaces, along with dashboards and reports, are available in your production environment. Также необходимо будет убедиться, что приложение создано в Azure AD для рабочего клиента и для этого приложения назначены соответствующие разрешения, как описано на шаге 1.You will also need to make sure that you created the application in Azure AD for your production tenant and assigned the proper app permissions as indicated in Step 1.

  • Приобретите необходимый размер емкости.Purchase a capacity that fits your needs. Чтобы определиться, какой объем и тип вам нужны, см. технический документ по планированию ресурсов аналитики Power BI Embedded.To better understand how the amount and type of capacity you need, see the Power BI Embedded analytics capacity planning whitepaper. Вы можете приобрести емкость в Azure.You can purchase capacity in Azure.

  • Измените рабочую область приложения и переместите ее в емкость Premium в диалоговом окне "Дополнительно".Edit the App workspace and assign it to a Premium capacity under advanced.

    Емкость Premium

  • Разверните обновленное приложение в рабочую среду и приступите к внедрению отчетов из Power BI Embedded.Deploy your updated application to production and begin embedding reports from the Power BI Embedded.

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

После переноса необходимо сделать некоторые очистки в Azure.You should do some cleanup within Azure.

  • Удалите все рабочие области развернутого решения в коллекции рабочих областей Power BI Azure.Remove all workspaces off of the deployed solution within the Azure Embedded of Power BI Workspace Collection.
  • Удалите все имеющиеся в Azure коллекции рабочей области.Delete any Workspace Collections that exist within Azure.

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

Внедрение в Power BIEmbedding with Power BI
Средство миграции коллекции рабочих областей Power BIPower BI Workspace Collection migration tool
Фрагменты кода для переноса содержимого из коллекции рабочих областей Power BICode snippets for migrating content from Power BI Workspace Collection
Как внедрять панели мониторинга, отчеты и плитки Power BIHow to embed your Power BI dashboards, reports and tiles
Что такое Power BI Premium?Power BI Premium - what is it?
Репозиторий Git JavaScript APIJavaScript API Git repo
Репозиторий Git Power BI C#Power BI C# Git repo
Пример внедрения JavaScriptJavaScript embed sample
Технический документ по планированию ресурсов аналитики коллекции рабочих областейWorkspace Collection analytics capacity planning whitepaper
Техническая документация по Power BI PremiumPower BI Premium whitepaper

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