Этот инструмент переноса можно использовать для копирования отчетов из службы Azure Power BI Embedded (PaaS) в службу Power BI (SaaS).

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

Ограничения

  • Отправленные наборы данных нельзя скачать. Их потребуется создать повторно с помощью интерфейсов REST API Power BI для службы Power BI.
  • PBIX-файлы, импортированные до 26 ноября 2016 г., нельзя будет скачать.

Скачать

Пример инструмента переноса доступен на сайте GitHub. Можно скачать ZIP-файл репозитория или клонировать его локально. Затем вы можете открыть файл powerbi-migration-sample.sln в Visual Studio для сборки и запуска инструмента переноса.

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

План переноса — это просто метаданные, которые упорядочивают содержимое в каталоги в Power BI Embedded, и способ их публикации в службе Power BI.

Создание нового плана переноса

План переноса — это метаданные доступных в Power BI Embedded элементов, которые необходимо перенести в службу Power BI. План переноса хранится в виде XML-файла.

Сначала необходимо создать план переноса. Для этого сделайте следующее:

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

  2. В диалоговом окне Select Power BI Embedded Resource Group (Выбор группы ресурсов Power BI Embedded) необходимо выбрать в раскрывающемся списке "Среда" рабочую среду.

  3. Вам будет предложено выполнить вход. Используйте имя входа подписки Azure.

    Важно!

    Это не рабочая учетная запись Office 365, которую вы используете для входа в Power BI.

  4. Выберите подписку Azure, где хранятся коллекции рабочей области Power BI Embedded.

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

  6. Нажмите кнопку Анализ. Таким образом вы получите список элементов в подписке Azure, чтобы начать создание плана.

    Примечание.

    Анализ может занять несколько минут в зависимости от количества коллекций рабочей области и объема содержимого в коллекции рабочей области.

  7. Когда анализ будет завершен, вам будет предложено сохранить план переноса.

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

Сохранение плана переноса

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

Чтобы сохранить план переноса, сделайте следующее:

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

  2. Присвойте файлу имя или используйте созданное имя файла и нажмите кнопку Сохранить.

Открытие существующего плана переноса

Вы можете открыть сохраненный план переноса, чтобы продолжить работу над переносом.

Чтобы открыть существующий план переноса, сделайте следующее:

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

  2. Выберите файл переноса и щелкните Открыть.

Шаг 1. Анализ и планирование переноса

Вкладка Analyze & Plan Migration (Анализ и планирование переноса) позволяет получить представление о том, какие ресурсы в настоящее время входят в группу ресурсов подписки Azure.

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

В качестве примера мы рассмотрим группу SampleResourceGroup.

Топология PaaS

Ниже приведено представление Группа ресурсов > Коллекции рабочей области > Рабочие области. Для группы ресурсов и коллекций рабочей области будет отображаться понятное имя, а для рабочих областей — идентификатор GUID.

Элементы в списке могут быть разного цвета. Они отображаются с числом в формате (№/№). Это количество отчетов, которые можно скачать. Черный цвет означает, что все отчеты можно скачать.

Красный цвет означает, что все отчеты нельзя скачать. Число слева указывает общее количество отчетов, которые можно скачать. Число справа показывает общее количество отчетов внутри группы.

Вы можете выбрать элемент в топологии PaaS для отображения отчетов в разделе "Отчеты".

Отчеты

В разделе "Отчеты" содержатся доступные отчеты с пометкой о том, можно ли их скачать.

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

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

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

Путь будет создан автоматически. При желании его можно изменить. В таком случае необходимо выбрать Update paths (Обновить пути).

Примечание.

При этом само скачивание не выполняется. Вы просто указываете структуру, в которую будут скачаны отчеты.

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

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

Примечание.

Этим действием вы не создаете группы в службе Power BI. Вы просто определяете структуру именования для групп.

В случае изменения префикса необходимо выбрать Generate Upload Plan (Создать план передачи).

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

Примечание.

Имя группы не должно содержать пробелы и недопустимые знаки.

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

На вкладке Скачивание содержится список отчетов и связанные метаданные. Здесь вы увидите текущее и предыдущее состояния экспорта.

У вас есть два варианта.

  • Выберите конкретные отчеты и нажмите кнопку Скачать выбранные.
  • Нажмите кнопку Скачать все.

Для успешной загрузки отобразится состояние Готово и существующий PBIX-файл.

После завершения скачивания выберите вкладку Create Groups (Создание групп).

Шаг 3. Создание групп

После скачивания доступных отчетов можно перейти на вкладку Create Groups (Создание групп). На этой вкладке будут созданы рабочие области приложения в службе Power BI на основе созданного плана переноса. Рабочие области приложения будут иметь имена, указанные на вкладке Upload (Передача) в разделе Analyze & Plan Migration (Анализ и планирование переноса).

Чтобы создать рабочие области приложения, можно нажать кнопку Create Selected Groups (Создать выбранные группы) или Create All Missing Groups (Создать все отсутствующие группы).

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

Будет создана рабочая область приложения в службе Power BI. При этом в рабочую область приложения не будут переданы отчеты.

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

После создания рабочей области можно перейти на вкладку Upload (Передача).

Шаг 4. Передача

На вкладке Upload (Передача) можно передать отчеты в службу Power BI. Вы увидите список отчетов, которые мы скачали на вкладке скачивания, а также имя целевой группы в соответствии с планом переноса.

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

Вы также можете выбрать, что делать, если отчет с таким именем уже существует: прервать, игнорировать или перезаписать.

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

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

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

В приведенном выше примере один из клонированных отчетов не удалось передать, так как отчет с таким именем уже существует. Если открыть XML-файл плана переноса, вы увидите там следующее:

<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.

<SaaSTargetReportName>cloned2</SaaSTargetReportName>

Затем можно повторно открыть план в инструменте переноса и передать этот отчет.

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

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

Вы можете передать локальную версию файла Power BI Desktop. Для этого закройте инструмент и в XML-файле укажите полный путь к локальному PBIX-файлу в свойстве PbixPath.

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

После изменения XML-файла повторно откройте план в инструменте переноса и передайте отчет.

Отчеты DirectQuery

Вам понадобится обновить строку подключения для отчетов DirectQuery. Это можно сделать на сайте powerbi.com, или же программными средствами запросите строку подключения из Power BI Embedded (PaaS). Пример см. в разделе Extract DirectQuery connection string from PaaS report (Извлечение строки подключения DirectQuery из отчета PaaS).

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

Внедрение

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

Дополнительные сведения см. в статье Как перенести содержимое коллекции рабочих областей Power BI Embedded в Power BI.

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

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

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