Встроенный инструмент миграции Power BIPower BI Embedded migration tool

Этот инструмент переноса можно использовать для копирования отчетов из службы Azure Power BI Embedded (PaaS) в службу Power BI (SaaS).This migration tool can be used to copy your reports from the Power BI Embedded Azure service (PaaS) to the Power BI service (SaaS).

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

ОграниченияLimitations

  • Отправленные наборы данных нельзя скачать. Их потребуется создать повторно с помощью интерфейсов REST API Power BI для службы Power BI.Pushed datasets cannot be downloaded and will need to be recreated using the Power BI REST APIs for the Power BI service.
  • PBIX-файлы, импортированные до 26 ноября 2016 г., нельзя будет скачать.PBIX files imported before November 26, 2016 will not be downloadable.

СкачатьDownload

Пример инструмента переноса доступен на сайте GitHub.You can download the migration tool sample from GitHub. Можно скачать ZIP-файл репозитория или клонировать его локально.You can either download a zip of the repository, or you can clone it locally. Затем вы можете открыть файл powerbi-migration-sample.sln в Visual Studio для сборки и запуска инструмента переноса.Once downloaded, you can open powerbi-migration-sample.sln within Visual Studio to build and run the migration tool.

Планы переносаMigration Plans

План переноса — это просто метаданные, которые упорядочивают содержимое в каталоги в Power BI Embedded, и способ их публикации в службе Power BI.Your migration plan is just metadata that catalogs the content within Power BI Embedded and how you want to publish them to the Power BI service.

Создание нового плана переносаStart with a new migration plan

План переноса — это метаданные доступных в Power BI Embedded элементов, которые необходимо перенести в службу Power BI.A migration plan is the metadata of the items available in Power BI Embedded that you then want to move over to the Power BI service. План переноса хранится в виде XML-файла.The migration plan is stored as an XML file.

Сначала необходимо создать план переноса.You will want to start by creating a new migration plan. Для этого сделайте следующее:To create a new migration plan, do the following.

  1. Выберите Файл > New Migration Plan (Новый план переноса).Select File > New Migration Plan.

  2. В диалоговом окне Select Power BI Embedded Resource Group (Выбор группы ресурсов Power BI Embedded) необходимо выбрать в раскрывающемся списке "Среда" рабочую среду.In the Select Power BI Embedded Resource Group dialog, you will want to select the Environment dropdown and select prod.

  3. Вам будет предложено выполнить вход.You will be prompted to sign in. Используйте имя входа подписки Azure.You will use your Azure subscription login.

    Важно!

    Это не рабочая учетная запись Office 365, которую вы используете для входа в Power BI.This is not your Office 365 organization account that you sign into Power BI with.

  4. Выберите подписку Azure, где хранятся коллекции рабочей области Power BI Embedded.Select the Azure subscription which stores your Power BI Embedded workspace collections.

  5. Под списком подписок выберите группу ресурсов, содержащую коллекции рабочей области, и нажмите кнопку Выбрать.Below the subscription list, select the Resource Group that contains your workspace collections and select Select.

  6. Нажмите кнопку Анализ.Select Analyze. Таким образом вы получите список элементов в подписке Azure, чтобы начать создание плана.This will get an inventory of the items within your Azure subscription for you to begin your plan.

    Примечание

    Анализ может занять несколько минут в зависимости от количества коллекций рабочей области и объема содержимого в коллекции рабочей области.The analyze process could take several minutes depending on the number of Workspace collections and how much content exists in the workspace collection.

  7. Когда анализ будет завершен, вам будет предложено сохранить план переноса.When Analyze is complete, it will prompt you to save your migration plan.

На этом этапе вы уже подключили план переноса к подписке Azure.At this point, you have connected your migration plan to your Azure subscription. В следующих разделах вы узнаете, как работать с планом переноса,Read below to understand the flow of how to work with your migration plan. в частности как анализировать и планировать перенос, создавать группы, а также как выполнять скачивание и передачу.This includes Analyze & Plan Migration, Download, Create Groups and Upload.

Сохранение плана переносаSave your migration plan

Вы можете сохранить план переноса для последующего использования.You can save your migration plan for use later. При этом будет создан XML-файл со всеми данными, указанными в плане переноса.This will create an XML file that contained all the information in your migration plan.

Чтобы сохранить план переноса, сделайте следующее:To save your migration plan, do the following.

  1. Выберите Файл > Save Migration Plan (Сохранить план переноса).Select File > Save Migration Plan.

  2. Присвойте файлу имя или используйте созданное имя файла и нажмите кнопку Сохранить.Give your file a name or use the generated file name and select Save.

Открытие существующего плана переносаOpen an existing migration plan

Вы можете открыть сохраненный план переноса, чтобы продолжить работу над переносом.You can open a saved migration plan to continue working on your migration.

Чтобы открыть существующий план переноса, сделайте следующее:To open your existing migration plan, do the following.

  1. Выберите Файл > Open Existing Migration Plan (Открыть существующий план переноса).Select File > Open Existing Migration Plan.

  2. Выберите файл переноса и щелкните Открыть.Select your migration file and select Open.

Шаг 1. Анализ и планирование переносаStep 1: Analyze & Plan Migration

Вкладка Analyze & Plan Migration (Анализ и планирование переноса) позволяет получить представление о том, какие ресурсы в настоящее время входят в группу ресурсов подписки Azure.The Analyze & Plan Migration tab gives you a view of what is currently in your Azure subscription’s resource group.

Вкладка Analyze & Plan Migration (Анализ и планирование переноса)

В качестве примера мы рассмотрим группу SampleResourceGroup.We will look at the SampleResourceGroup as an example.

Топология PaaSPaaS Topology

Ниже приведено представление Группа ресурсов > Коллекции рабочей области > Рабочие области.This is a listing of your Resource Group > Workspace collections > Workspaces. Для группы ресурсов и коллекций рабочей области будет отображаться понятное имя,The resource group and workspace collections will show a friendly name. а для рабочих областей — идентификатор GUID.The workspaces will show a GUID.

Элементы в списке могут быть разного цвета. Они отображаются с числом в формате (№/№).The items in the list will also display a color and a number in the format of (#/#). Это количество отчетов, которые можно скачать.This indicates the number of reports that can be downloaded. Черный цвет означает, что все отчеты можно скачать.A black color means that all reports can be downloaded.

Красный цвет означает, что все отчеты нельзя скачать.A red color means that some reports cannot be downloaded. Число слева указывает общее количество отчетов, которые можно скачать.The left number will indicate the total number of reports that can be downloaded. Число справа показывает общее количество отчетов внутри группы.The number on the right indicates the total number of reports within the grouping.

Вы можете выбрать элемент в топологии PaaS для отображения отчетов в разделе "Отчеты".You can select an item within the PaaS topology to display the reports in the reports section.

ОтчетыReports

В разделе "Отчеты" содержатся доступные отчеты с пометкой о том, можно ли их скачать.The reports section will list out the reports available and indicates whether it can be downloaded or not.

Целевая структураTarget structure

Целевая структура позволяет указать место для скачивания элементов, а также способ их передачи.The Target structure is where you tell the tool where things will be downloaded to and how to upload them.

План скачиванияDownload Plan

Путь будет создан автоматически.A path will automatically be created for you. При желании его можно изменить.You can change this path if you wish. В таком случае необходимо выбрать Update paths (Обновить пути).If you do change the path, you will need to select Update paths.

Примечание

При этом само скачивание не выполняется.This does not actually perform the download. Вы просто указываете структуру, в которую будут скачаны отчеты.This is only specifying the structure of where the reports will be downloaded to.

План передачиUpload Plan

Здесь можно указать префикс для рабочих областей приложения, которые будут созданы в службе Power BI.Here you can specify a prefix to be used for the App Workspaces that will be created within the Power BI service. Затем префикс будет использоваться как идентификатор GUID для рабочей области, которая существовала в Azure.After the prefix will be the GUID for the workspace that existed in Azure.

Примечание

Этим действием вы не создаете группы в службе Power BI.This does not actually create the groups within the Power BI service. Вы просто определяете структуру именования для групп.This only defines the naming structure for the groups.

В случае изменения префикса необходимо выбрать Generate Upload Plan (Создать план передачи).If you change the prefix, you will need to select Generate Upload Plan.

При необходимости вы можете щелкнуть группу правой кнопкой мыши и выбрать команду, чтобы переименовать группу прямо в плане передачи.You can right click on a group and choose to rename the group within the Upload plan directly, if desired.

Примечание

Имя группы не должно содержать пробелы и недопустимые знаки.The name of the group must not contain spaces or invalid characters.

Шаг 2. СкачиваниеStep 2: Download

На вкладке Скачивание содержится список отчетов и связанные метаданные.On the Download tab, you will see the list of reports and associated metadata. Здесь вы увидите текущее и предыдущее состояния экспорта.You can see what the export status is along with the previous export status.

У вас есть два варианта.You have two options.

  • Выберите конкретные отчеты и нажмите кнопку Скачать выбранные.Select specific reports and select Download Selected
  • Нажмите кнопку Скачать все.Select Download All.

Для успешной загрузки отобразится состояние Готово и существующий PBIX-файл.For a successful download, you will see a status of Done and it will reflect that the PBIX file exists.

После завершения скачивания выберите вкладку Create Groups (Создание групп).After the download is completed, select the Create Groups tab.

Шаг 3. Создание группStep 3: Create Groups

После скачивания доступных отчетов можно перейти на вкладку Create Groups (Создание групп). На этой вкладке будут созданы рабочие области приложения в службе Power BI на основе созданного плана переноса.After you have downloaded the reports that are available, you can go to the Create Groups tab. This tab will create the app workspaces within the Power BI service based on the migration plan that you created. Рабочие области приложения будут иметь имена, указанные на вкладке Upload (Передача) в разделе Analyze & Plan Migration (Анализ и планирование переноса).It will create the app workspace with the name you provided on the Upload tab within Analyze & Plan Migration.

Чтобы создать рабочие области приложения, можно нажать кнопку Create Selected Groups (Создать выбранные группы) или Create All Missing Groups (Создать все отсутствующие группы).To create the app workspaces, you can select either Create Selected Groups or Create All Missing Groups.

При выборе любого из этих вариантов вам будет предложено войти.When you select either of these options, you will be prompted to sign in. Необходимо использовать учетные данные для службы Power BI, в которой нужно создать рабочие области приложения.You will want to use your credentials for the Power BI service that you want to create the app workspaces on.

Будет создана рабочая область приложения в службе Power BI.This will create the app workspace within the Power BI service. При этом в рабочую область приложения не будут переданы отчеты.This does not upload the reports to the app workspace.

Вы можете проверить, создана ли рабочая область приложения, выполнив вход в службу Power BI.You can verify that the app workspace was created by signing into Power BI and validating that the workspace exists. Вы увидите, что в рабочей области ничего нет.You will notice that nothing is in the workspace.

После создания рабочей области можно перейти на вкладку Upload (Передача).After the workspace is created, you can move onto the Upload tab.

Шаг 4. ПередачаStep 4: Upload

На вкладке Upload (Передача) можно передать отчеты в службу Power BI.On the Upload tab, this will upload the reports to the Power BI service. Вы увидите список отчетов, которые мы скачали на вкладке скачивания, а также имя целевой группы в соответствии с планом переноса.You will see a list of the reports that we downloaded on the Download tab along with the target group name based on your migration plan.

Можно передать выбранные или все отчеты.You can upload selected reports, or you could upload all the reports. Можно также сбросить состояние передачи для повторной передачи элементов.You can also reset the upload status to re-upload items.

Вы также можете выбрать, что делать, если отчет с таким именем уже существует:You also have the option of selecting what to do if a report with the same name exists. прервать, игнорировать или перезаписать.You can choose between Abort, Ignore and Overwrite.

Повторяющиеся имена отчетовDuplicate report names

Если у вас есть отчет с таким же именем, но вы знаете, что это другой отчет, необходимо изменить его целевое имя.If you have a report that has the same name, but you know it is a different report, you will need to change the TargetName of the report. Это нужно сделать вручную в XML-файле плана переноса.You can change the name by manually editing the migration plan XML.

Чтобы внести изменения, необходимо закрыть инструмент переноса, а затем снова открыть его и план переноса.You will need to close the migration tool to make the change and then re-open the tool and the migration plan.

В приведенном выше примере один из клонированных отчетов не удалось передать, так как отчет с таким именем уже существует.In the above example, one of the cloned reports failed indicating a report with the same name existed. Если открыть XML-файл плана переноса, вы увидите там следующее:If we go look at the migration plan XML, we will see the following.

<ReportMigrationData>
    <PaaSWorkspaceCollectionName>SampleWorkspaceCollection</PaaSWorkspaceCollectionName>
    <PaaSWorkspaceId>4c04147b-d8fc-478b-8dcb-bcf687149823</PaaSWorkspaceId>
    <PaaSReportId>525a8328-b8cc-4f0d-b2cb-c3a9b4ba2efe</PaaSReportId>
    <PaaSReportLastImportTime>1/3/2017 2:10:19 PM</PaaSReportLastImportTime>
    <PaaSReportName>cloned</PaaSReportName>
    <IsPushDataset>false</IsPushDataset>
    <IsBoundToOldDataset>false</IsBoundToOldDataset>
    <PbixPath>C:\MigrationData\SampleResourceGroup\SampleWorkspaceCollection\4c04147b-d8fc-478b-8dcb-bcf687149823\cloned-525a8328-b8cc-4f0d-b2cb-c3a9b4ba2efe.pbix</PbixPath>
    <ExportState>Done</ExportState>
    <LastExportStatus>OK</LastExportStatus>
    <SaaSTargetGroupName>SampleMigrate</SaaSTargetGroupName>
    <SaaSTargetGroupId>6da6f072-0135-4e6c-bc92-0886d8aeb79d</SaaSTargetGroupId>
    <SaaSTargetReportName>cloned</SaaSTargetReportName>
    <SaaSImportState>Failed</SaaSImportState>
    <SaaSImportError>Report with the same name already exists</SaaSImportError>
</ReportMigrationData>

Для файла, который не удалось отправить, можно изменить имя SaaSTargetReportName.For the failed item, we can change the name of the SaaSTargetReportName.

<SaaSTargetReportName>cloned2</SaaSTargetReportName>

Затем можно повторно открыть план в инструменте переноса и передать этот отчет.We can then re-open the plan, in the migration tool, and upload the failed report.

Вернувшись в Power BI, мы видим, что отчеты и наборы данных были переданы в рабочую область приложения.Going back to Power BI, we can see that the reports and datasets have been uploaded in the app workspace.

Передача локального PBIX-файлаUpload a local PBIX file

Вы можете передать локальную версию файла Power BI Desktop.You can upload a local version of a Power BI Desktop file. Для этого закройте инструмент и в XML-файле укажите полный путь к локальному PBIX-файлу в свойстве PbixPath.You will have to close the tool, edit the XML and put the full path to your local PBIX in the PbixPath property.

<PbixPath>[Full Path to PBIX file]</PbixPath>

После изменения XML-файла повторно откройте план в инструменте переноса и передайте отчет.After you have edited the xml, re-open the plan within the migration tool and upload the report.

Отчеты DirectQueryDirectQuery reports

Вам понадобится обновить строку подключения для отчетов DirectQuery.You will need to update to update the connection string for DirectQuery reports. Это можно сделать на сайте powerbi.com, или же программными средствами запросите строку подключения из Power BI Embedded (PaaS).This can be done within powerbi.com, or you can programmatically query the connection string from Power BI Embedded (Paas). Пример см. в разделе Extract DirectQuery connection string from PaaS report (Извлечение строки подключения DirectQuery из отчета PaaS).For an example, see Extract DirectQuery connection string from PaaS report.

Затем можно обновить строку подключения для набора данных в службе Power BI (SaaS) и задать учетные данные для источника данных.You can then update the connection string for the dataset within the Power BI service (Saas) and set the credentials for the data source. Для этого см. следующие разделы:You can look at the following examples to see how to do this.

ВнедрениеEmbedding

Теперь, когда отчеты перенесены из службы Azure Power BI Embedded в службу Power BI, можно обновить приложение и начать внедрение отчетов в этой рабочей области приложения.Now that your reports have been migrated from the Power BI Embedded Azure service to the Power BI service, you can now update your application and begin embedding the reports in this app workspace.

Дополнительные сведения см. в статье Как перенести содержимое коллекции рабочих областей Power BI Embedded в Power BI.For more information, see How to migrate Power BI Embedded workspace collection content to Power BI.

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

Внедрение в Power BIEmbedding with Power BI
Как перенести содержимое коллекции рабочих областей Power BI Embedded в Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Что такое 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
Техническая документация по Power BI PremiumPower BI Premium whitepaper

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