Ferramenta de migração Power BI EmbeddedPower BI Embedded migration tool

Essa ferramenta de migração pode ser usada para copiar seus relatórios do serviço Power BI Embedded do Azure (PaaS) para o serviço do 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).

A migração do conteúdo de suas coleções de espaços de trabalho para o serviço do Power BI poderá ser feita paralelamente à sua solução atual e não requer nenhum tempo de inatividade.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.

LimitaçõesLimitations

  • Conjuntos de dados enviados por push não podem ser baixados e precisarão ser recriados usando as APIs REST do Power BI para o serviço do Power BI.Pushed datasets cannot be downloaded and will need to be recreated using the Power BI REST APIs for the Power BI service.
  • Arquivos PBIX importados antes de 26 de novembro de 2016 não estarão disponíveis para download.PBIX files imported before November 26, 2016 will not be downloadable.

DownloadDownload

É possível baixar o exemplo da ferramenta de migração no GitHub.You can download the migration tool sample from GitHub. Você pode baixar um zip do repositório ou pode cloná-lo localmente.You can either download a zip of the repository, or you can clone it locally. Após o download, você pode abrir powerbi-migration-sample.sln dentro do Visual Studio para compilar e executar a ferramenta de migração.Once downloaded, you can open powerbi-migration-sample.sln within Visual Studio to build and run the migration tool.

Planos de migraçãoMigration Plans

Seu plano de migração são apenas metadados que catalogam o conteúdo no Power BI Embedded e como você deseja publicá-lo no serviço do 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.

Iniciar com um novo plano de migraçãoStart with a new migration plan

Um plano de migração são os metadados dos itens disponíveis no Power BI Embedded que você deseja mover para o serviço do 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. O plano de migração é armazenado como um arquivo XML.The migration plan is stored as an XML file.

Comece criando um novo plano de migração.You will want to start by creating a new migration plan. Para criar um novo plano de migração, faça o seguinte.To create a new migration plan, do the following.

  1. Selecione Arquivo > Novo Plano de Migração.Select File > New Migration Plan.

  2. Na caixa de diálogo Selecionar grupo de recursos do Power BI Embedded, selecione o menu suspenso Ambiente e selecione Produção.In the Select Power BI Embedded Resource Group dialog, you will want to select the Environment dropdown and select prod.
  3. Será solicitado que você entre.You will be prompted to sign in. Você usará seu logon de assinatura do Azure.You will use your Azure subscription login.

    Importante

    Não se trata da conta da organização do Office 365 que você usa para entrar no Power BI.This is not your Office 365 organization account that you sign into Power BI with.

  4. Selecione a assinatura do Azure que armazena suas coleções de espaços de trabalho do Power BI Embedded.Select the Azure subscription which stores your Power BI Embedded workspace collections.

  5. Abaixo da lista de assinaturas, selecione o Grupo de Recursos que contém suas coleções de espaços de trabalho e selecione Selecionar.Below the subscription list, select the Resource Group that contains your workspace collections and select Select.

  6. Selecione Analisar.Select Analyze. Isso retornará um inventário dos itens dentro de sua assinatura do Azure para você começar seu plano.This will get an inventory of the items within your Azure subscription for you to begin your plan.

    Observação

    O processo de análise pode levar vários minutos dependendo do número de coleções de espaços de trabalho e da quantidade de conteúdo que existe na coleção de espaços de trabalho.The analyze process could take several minutes depending on the number of Workspace collections and how much content exists in the workspace collection.

  7. Quando o processo de Analisar estiver concluído, será solicitado que você salve seu plano de migração.When Analyze is complete, it will prompt you to save your migration plan.

Neste ponto, você conectou seu plano de migração à sua assinatura do Azure.At this point, you have connected your migration plan to your Azure subscription. Leia abaixo para entender o fluxo de como trabalhar com seu plano de migração.Read below to understand the flow of how to work with your migration plan. Ele inclui Analisar e Planejar a Migração, Baixar, Criar Grupos e Carregar.This includes Analyze & Plan Migration, Download, Create Groups and Upload.

Salvar o plano de migraçãoSave your migration plan

Você pode salvar o plano de migração para usá-lo posteriormente.You can save your migration plan for use later. Isso criará um arquivo XML contento todas as informações em seu plano de migração.This will create an XML file that contained all the information in your migration plan.

Para salvar seu plano de migração, faça o seguinte.To save your migration plan, do the following.

  1. Selecione Arquivo > Salvar Plano de Migração.Select File > Save Migration Plan.

  2. Nomeie o arquivo ou use o nome de arquivo gerado e selecione Salvar.Give your file a name or use the generated file name and select Save.

Abrir um plano de migração existenteOpen an existing migration plan

Você pode abrir um plano de migração salvo para continuar trabalhando na migração.You can open a saved migration plan to continue working on your migration.

Para abrir o plano de migração existente, faça o seguinte.To open your existing migration plan, do the following.

  1. Selecione Arquivo > Abrir Plano de Migração Existente.Select File > Open Existing Migration Plan.

  2. Selecione o arquivo de migração e selecione Abrir.Select your migration file and select Open.

Etapa 1: Analisar e Planejar a MigraçãoStep 1: Analyze & Plan Migration

A guia Analisar e Planejar a Migração fornece um panorama do que está no grupo de recursos de sua assinatura do Azure.The Analyze & Plan Migration tab gives you a view of what is currently in your Azure subscription’s resource group.

Guia Analisar e Planejar a Migração

Examinaremos SampleResourceGroup como exemplo.We will look at the SampleResourceGroup as an example.

Topologia de PaaSPaaS Topology

Essa é uma lista de Grupo de Recursos > Coleções de espaços de trabalho > Espaços de trabalho.This is a listing of your Resource Group > Workspace collections > Workspaces. As coleções de espaços de trabalho e o grupo de recursos mostrarão um nome amigável.The resource group and workspace collections will show a friendly name. Os espaços de trabalho mostrarão um GUID.The workspaces will show a GUID.

Os itens na lista também exibirão uma cor e um número no formato (#/#).The items in the list will also display a color and a number in the format of (#/#). Isso indica o número de relatórios que podem ser baixados.This indicates the number of reports that can be downloaded. A cor preta significa que todos os relatórios podem ser baixados.A black color means that all reports can be downloaded.

A cor vermelha significa que alguns relatórios não podem ser baixados.A red color means that some reports cannot be downloaded. O número à esquerda indica o número total de relatórios que podem ser baixados.The left number will indicate the total number of reports that can be downloaded. O número à direita indica o número total de relatórios no agrupamento.The number on the right indicates the total number of reports within the grouping.

Você pode selecionar um item dentro da topologia de PaaS para exibir os relatórios na seção de relatórios.You can select an item within the PaaS topology to display the reports in the reports section.

RelatóriosReports

A seção de relatórios listará os relatórios disponíveis e indicará se eles podem ser baixados ou não.The reports section will list out the reports available and indicates whether it can be downloaded or not.

Estrutura de destinoTarget structure

A Estrutura de destino é onde você informa à ferramenta onde os itens serão baixados e como carregá-los.The Target structure is where you tell the tool where things will be downloaded to and how to upload them.

Plano de downloadDownload Plan

Um caminho será criado automaticamente para você.A path will automatically be created for you. Se desejar, você poderá alterar esse caminho.You can change this path if you wish. Se alterar o caminho, você precisará selecionar Atualizar caminhos.If you do change the path, you will need to select Update paths.

Observação

Isso não executa o download.This does not actually perform the download. Isso só especifica a estrutura do local para o local em que os relatórios serão baixados.This is only specifying the structure of where the reports will be downloaded to.

Plano de uploadUpload Plan

Aqui, você pode especificar um prefixo para ser usado para os Espaços de Trabalho do Aplicativo que serão criados no serviço do Power BI.Here you can specify a prefix to be used for the App Workspaces that will be created within the Power BI service. Depois do prefixo, estará o GUID do espaço de trabalho que existia no Azure.After the prefix will be the GUID for the workspace that existed in Azure.

Observação

Isso não cria os grupos no serviço do Power BI.This does not actually create the groups within the Power BI service. Isso apenas define a estrutura de nomenclatura dos grupos.This only defines the naming structure for the groups.

Se alterar o prefixo, você precisará selecionar Gerar Plano de Upload.If you change the prefix, you will need to select Generate Upload Plan.

Você pode clicar com o botão direito do mouse em um grupo e escolher renomear o grupo diretamente no plano de upload, se desejado.You can right click on a group and choose to rename the group within the Upload plan directly, if desired.

Observação

O nome do grupo não pode conter espaços ou caracteres inválidos.The name of the group must not contain spaces or invalid characters.

Etapa 2: BaixarStep 2: Download

Na guia Baixar, você verá a lista de relatórios e os metadados associados.On the Download tab, you will see the list of reports and associated metadata. Você pode ver qual é o status da exportação, junto com o status da exportação anterior.You can see what the export status is along with the previous export status.

Você tem duas opções.You have two options.

  • Selecionar relatórios específicos e selecionar Baixar SelecionadosSelect specific reports and select Download Selected
  • Selecionar Baixar Todos.Select Download All.

Para um download bem-sucedido, você verá o status Concluído e ele refletirá que o arquivo PBIX existe.For a successful download, you will see a status of Done and it will reflect that the PBIX file exists.

Depois que o download for concluído, selecione a guia Criar Grupos.After the download is completed, select the Create Groups tab.

Etapa 3: Criar GruposStep 3: Create Groups

Após ter baixado os relatórios disponíveis, você pode ir para a guia Criar Grupos. Esta guia criará os espaços de trabalho do aplicativo no serviço do Power BI com base no plano de migração que você criou.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. Ela criará o espaço de trabalho do aplicativo com o nome fornecido na guia Carregar em Analisar e Planejar a Migração.It will create the app workspace with the name you provided on the Upload tab within Analyze & Plan Migration.

Para criar os espaços de trabalho do aplicativo, você pode selecionar Criar Grupos Selecionados ou Criar Todos os Grupos Ausentes.To create the app workspaces, you can select either Create Selected Groups or Create All Missing Groups.

Quando selecionar uma dessas opções, você será solicitado a entrar.When you select either of these options, you will be prompted to sign in. Use as credenciais do serviço do Power BI no qual você deseja criar os espaços de trabalho do aplicativo.You will want to use your credentials for the Power BI service that you want to create the app workspaces on.

Isso criará o espaço de trabalho do aplicativo no serviço do Power BI.This will create the app workspace within the Power BI service. Os relatórios não serão carregados no espaço de trabalho do aplicativo.This does not upload the reports to the app workspace.

Você pode confirmar se o espaço de trabalho do aplicativo foi criado entrando no Power BI e validando se o espaço de trabalho existe.You can verify that the app workspace was created by signing into Power BI and validating that the workspace exists. Você observará que não há nada no espaço de trabalho.You will notice that nothing is in the workspace.

Após o espaço de trabalho ser sido criado, você poderá passar para a guia Carregar.After the workspace is created, you can move onto the Upload tab.

Etapa 4: CarregarStep 4: Upload

Na guia Carregar, os relatórios serão carregados para o serviço do Power BI.On the Upload tab, this will upload the reports to the Power BI service. Você verá uma lista dos relatórios baixados na guia Baixar, em conjunto com o nome do grupo de destino com base em seu plano de migração.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.

Você pode carregar relatórios selecionados ou pode carregar todos os relatórios.You can upload selected reports, or you could upload all the reports. Você também pode redefinir o status de upload para carregar itens novamente.You can also reset the upload status to re-upload items.

Você também tem a opção de selecionar o que deseja fazer se houver um relatório com o mesmo nome.You also have the option of selecting what to do if a report with the same name exists. Você pode escolher entre Anular, Ignorar e Substituir.You can choose between Abort, Ignore and Overwrite.

Nomes de relatório duplicadosDuplicate report names

Se tiver um relatório com o mesmo nome, mas souber que se trata de um relatório diferente, você precisará alterar o TargetName do relatório.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. Você pode alterar o nome editando manualmente o XML do plano de migração.You can change the name by manually editing the migration plan XML.

Você precisará fechar a ferramenta de migração para fazer a alteração e, em seguida, abrir novamente a ferramenta e o plano de migração.You will need to close the migration tool to make the change and then re-open the tool and the migration plan.

No exemplo acima, um dos relatórios clonados falhou indicando que existe um relatório com o mesmo nome.In the above example, one of the cloned reports failed indicating a report with the same name existed. Se examinarmos o XML do plano de migração, veremos o seguinte.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>

Para o item com falha, podemos alterar o nome do SaaSTargetReportName.For the failed item, we can change the name of the SaaSTargetReportName.

<SaaSTargetReportName>cloned2</SaaSTargetReportName>

Podemos, em seguida, abrir novamente o plano na ferramenta de migração e carregar o relatório com falha.We can then re-open the plan, in the migration tool, and upload the failed report.

Voltando ao Power BI, podemos ver que os relatórios e conjuntos de dados foram carregados no espaço de trabalho do aplicativo.Going back to Power BI, we can see that the reports and datasets have been uploaded in the app workspace.

Carregar um arquivo PBIX localUpload a local PBIX file

Você pode carregar uma versão local de um arquivo do Power BI Desktop.You can upload a local version of a Power BI Desktop file. Você precisará fechar a ferramenta, editar o XML e colocar o caminho completo para seu PBIX local na propriedade 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>

Depois de editar o xml, abra novamente o plano dentro da ferramenta de migração e carregue o relatório.After you have edited the xml, re-open the plan within the migration tool and upload the report.

Relatórios do DirectQueryDirectQuery reports

Você precisará atualizar a cadeia de conexão para relatórios do DirectQuery.You will need to update to update the connection string for DirectQuery reports. Isso pode ser feito no powerbi.com ou você pode consultar programaticamente a cadeia de conexão usando o Power BI Embedded (PaaS).This can be done within powerbi.com, or you can programmatically query the connection string from Power BI Embedded (Paas). Para ver um exemplo, consulte Extrair uma cadeia de conexão do DirectQuery do relatório de PaaS.For an example, see Extract DirectQuery connection string from PaaS report.

Você pode, então, atualizar a cadeia de conexão para o conjunto de dados no serviço do Power BI (SaaS) e definir as credenciais da fonte de dados.You can then update the connection string for the dataset within the Power BI service (Saas) and set the credentials for the data source. Você pode examinar os exemplos a seguir para saber como fazer isso.You can look at the following examples to see how to do this.

InserçãoEmbedding

Agora que seus relatórios foram migrados do serviço Power BI Embedded do Azure para o serviço do Power BI, você pode atualizar seu aplicativo e começar a inserir os relatórios neste espaço de trabalho do aplicativo.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.

Para obter mais informações, consulte Como migrar o conteúdo da coleção de espaços de trabalho do Power BI Embedded para o Power BI.For more information, see How to migrate Power BI Embedded workspace collection content to Power BI.

Próximas etapasNext steps

Inserindo com o Power BIEmbedding with Power BI
Como migrar o conteúdo da coleção do espaço de trabalho do Power BI Embedded para o Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Power BI Premium – o que é?Power BI Premium - what is it?
Repositório Git de API do JavaScriptJavaScript API Git repo
Repositório Git de C# do Power BIPower BI C# Git repo
Exemplo inserido do JavaScriptJavaScript embed sample
White paper do Power BI PremiumPower BI Premium whitepaper

Mais perguntas?More questions? Experimente perguntar à Comunidade do Power BITry asking the Power BI Community