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

Saiba como migrar do Power BI Embedded para o serviço do Power BI e aproveitar os avanços para inserir em aplicativos.Learn how to migrate from Power BI Embedded to the Power BI service and leverage advances for embedding in apps.

A Microsoft recentemente anunciou Power BI Premium, um novo modelo de licenciamento com base em capacidade que aumenta a flexibilidade de como os usuários acessam, compartilham e distribuem conteúdo.Microsoft recently announced Power BI Premium, a new capacity-based licensing model that increases flexibility for how users access, share and distribute content. A oferta também oferece desempenho e escalabilidade adicional para o serviço do Power BI.The offering also delivers additional scalability and performance to the Power BI service.

Com a introdução do Power BI Premium, o Power BI Embedded e o serviço do Power BI estão convergindo para avançar na maneira como o conteúdo do Power BI é inserido em aplicativos.With the introduction of Power BI Premium, Power BI Embedded and the Power BI service are converging to advance how Power BI content is embedded in apps. Isso significa que você terá uma superfície de API, um conjunto consistente de recursos e o acesso aos recursos mais recentes do Power BI, tais como dashboards, gateways e espaços de trabalho de aplicativo, ao inserir seu conteúdo.This means 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. Mais adiante você poderá iniciar com o Power BI Desktop e mudar para a implantação com o Power BI Premium, que estará disponível no final do segundo trimestre de 2017.Moving forward you’ll be able to start with Power BI Desktop and move to deployment with Power BI Premium, which will be generally available late in the second quarter of 2017.

O serviço atual do Power BI Embedded continuará disponível por um período limitado, após a disponibilidade geral da oferta convergida: os clientes com um Enterprise Agreement terão acesso até o final de seus contratos existentes; os clientes que adquiriram o Power BI Embedded por meio de canais Diretos ou CSP aproveitarão o acesso pelo período de um ano após a disponibilidade geral do Power BI Premium.The current Power BI Embedded service will continue to be available for a limited time following general availability of the converged offering: customers under an Enterprise Agreement will have access to through the expiration of their existing agreements; customers that acquired Power BI Embedded through Direct or CSP channels will enjoy access for one year from General Availability of Power BI Premium. Este artigo fornecerá algumas diretrizes para a migração do serviço do Azure para o serviço do Power BI e o que esperar em relação às alterações em seu aplicativo.This article will provide some guidance for migrating from the Azure service to the Power BI service and what to expect for changes in your application.

Importante

Enquanto que a migração receberá uma dependência do serviço do Power BI, não há uma dependência no Power BI para os usuários do seu aplicativo ao usarem um token de inserção.While the migration will take a dependency on the Power BI service, there is not a dependency on Power BI for the users of your application when using an embed token. Eles não precisa inscrever-se no Power BI para exibir o conteúdo inserido em seu aplicativo.They do not need to sign up for Power BI to view the embedded content in your application. É possível usar essa abordagem de inserção para atender usuários que não são do Power BI.You can use this embedding approach to service non-Power BI users.

Preparar para a migraçãoPrepare for the migration

Há algumas coisas que você precisa fazer para se preparar para migrar do serviço do Azure do Power BI Embedded para o serviço do Power BI.There are a few things you need to do to prepare for migrating from Power BI Embedded Azure service over to the Power BI service. Você precisará de um locatário disponível, junto com um usuário que tenha uma licença do Power BI Pro.You will need a tenant available, along with a user that has a Power BI Pro license.

  1. Verifique se que você tem acesso a um locatário do Azure Active Directory (Azure AD).Make sure you have access to an Azure Active Directory (Azure AD) tenant.

    Será necessário determinar qual configuração de locatário usar.You will need to determine what tenant setup to use.

  2. Crie um usuário nesse novo locatário que funcionará como sua conta mestre do aplicativo.Create a user within this new tenant that will act as your application "master" account. Essa conta precisa se inscrever no Power BI e ter uma licença Power BI Pro atribuída a ela.That account needs to sign up for Power BI and needs to have a Power BI Pro license assigned to it.

Contas no Azure ADAccounts within Azure AD

As seguintes contas precisarão existir no seu locatário.The following accounts will need to exist within your tenant.

Observação

Essas contas precisarão ter as licenças Power BI Pro para usar os espaços de trabalho do aplicativo.These accounts will need to have Power BI Pro licenses in order to use App workspaces.

  1. Um usuário administrador de locatário.A tenant admin user.

    É recomendável que esse usuário seja um membro de todos os Espaços de trabalho de aplicativo criados com a finalidade de inserção.It is recommended that this user be a member of all App workspaces created for the purpose of embedding.

  2. Contas para analistas que criarão conteúdo.Accounts for analysts that will create content.

    Esses usuários devem ser atribuídos aos Espaços de trabalho de aplicativo, conforme necessário.These users should be assigned to App workspaces as needed.

  3. Uma conta de usuário mestre de aplicativo ou conta de serviço.An application master user account, or service account.

    O back-end de aplicativos armazenará as credenciais dessa conta e a usará para adquirir um token do Azure AD para utilizar com as APIs REST do 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. Essa conta será usada para gerar o token de inserção para o aplicativo.This account will be used to generate the embed token for the application. Essa conta também precisa ser administrador dos Espaços de trabalho do aplicativo criados para a inserção.This account also needs to be an admin of the App workspaces created for embedding.

    Observação

    Essa é apenas uma conta de usuário regular na sua organização que será usada para fins de inserção.This is just a regular user account in your organziation that will be used for the purposes of embedding.

Registro do aplicativo e permissõesApp registration and permissions

Você precisará registrar um aplicativo no Azure AD e conceder permissões específicas.You will need to register an application within Azure AD and grant certain permissions.

Registrar um aplicativoRegister an application

Você precisará registrar seu aplicativo no Azure AD para fazer chamadas à API REST.You will need to register your application with Azure AD in order to make REST API calls. Isso inclui o acesso do portal do Azure para aplicar a configuração adicional, além do acesso da página de registro de aplicativo do Power BI.This includes going to the Azure portal to apply additional configuration in addition to the Power BI app registration page. Para obter mais informações, consulte Registrar um aplicativo do Azure AD para inserir o conteúdo do Power BI.For more information, see Register an Azure AD app to embed Power BI content.

Você deve registrar o aplicativo usando a conta mestre do aplicativo.You should register the application using the application master account.

Criar Espaços de trabalho de aplicativo (necessário)Create App workspaces (Required)

Você pode aproveitar os Espaços de trabalho de aplicativo para fornecer melhor isolamento, caso seu aplicativo esteja atendendo a vários clientes.You can take advantage of App workspaces to provide better isoliation if your application is servicing multiple customers. Os dashboards e relatórios ficariam isolados entre seus clientes.Dashboards and reports would be isolated between your customers. Você poderia usar uma conta do Power BI por Espaço de trabalho de aplicativo para isolar ainda mais as experiências de aplicativos entre seus clientes.You could then use a Power BI account per App workspace to further isolate application experiences between your customers.

Importante

Não é possível usar um espaço de trabalho pessoal para tirar proveito da inserção para usuários que não são do Power BI.You cannot use a personal workspace to take advantage of embedding to non-Power BI users.

Será necessário um usuário que tenha uma licença Pro para criar um Espaço de trabalho do aplicativo no Power BI.You will need a user that has a Pro license in order to create an app workspace within Power BI. O usuário do Power BI que criar o Espaço de trabalho de aplicativo será um administrador desse espaço de trabalho por padrão.The Power BI user that creates the App workspace will be an admin of that workspace by default.

Observação

A conta mestre do aplicativo precisa ser um administrador do espaço de trabalho.The application master account needs to be an admin of the workspace.

Migração de conteúdoContent migration

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.

Uma ferramenta de migração está disponível para uso a fim de ajudá-lo a copiar o conteúdo do Power BI Embedded para o serviço do Power BI.A migration tool is available for you to use in order to assist with copying content from Power BI Embedded to the Power BI service. Principalmente se você tiver muito conteúdo.Especially if you have a lot of content. Para obter mais informações, consulte Power BI Embedded migration tool (Ferramenta de migração do Power BI Embedded).For more information, see Power BI Embedded migration tool.

A migração de conteúdo depende principalmente de duas APIs.Content migration relies mainly on two APIs.

  1. Baixar PBIX – esta API pode baixar arquivos PBIX que foram carregados no Power BI depois de outubro de 2016.Download PBIX - this API can download PBIX files which were uploaded to Power BI after October 2016.
  2. Importar PBIX – esta API carrega qualquer PBIX no Power BI.Import PBIX - this API uploads any PBIX to Power BI.

Para alguns trechos de código relacionados, consulte Code snippets for migrating content from Power BI Embedded (Trechos de código para migrar conteúdo do Power BI Embedded).For some related code snippets, see Code snippets for migrating content from Power BI Embedded.

Tipos de relatórioReport types

Há vários tipos de relatórios, cada um requerendo um fluxo de migração um pouco diferente.There are several types of reports, each requiring a somewhat different migration flow.

Relatório e conjunto de dados armazenados em cacheCached dataset & report

Conjuntos de dados armazenados em cache referem-se a arquivos PBIX que tinham importado dados em vez de uma conexão dinâmica ou uma conexão do DirectQuery.Cached datasets refer to PBIX files that had imported data as opposed to a live connection or DirectQuery connection.

FluxoFlow

  1. Chame Baixar API de PBIX no espaço de trabalho PaaS.Call Download PBIX API from PaaS workspace.
  2. Salve o PBIX.Save PBIX.
  3. Chame Importar PBIX para o espaço de trabalho SaaS.Call Import PBIX to SaaS workspace.

Relatório e conjunto de dados do DirectQueryDirectQuery dataset & report

FluxoFlow

  1. Chame GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources e salve as cadeias de conexão recebidas.Call GET https://api.powerbi.com/v1.0/collections/{collection_id}/workspaces/{wid}/datasets/{dataset_id}/Default.GetBoundGatewayDataSources and save connection string received.
  2. Chame Baixar API de PBIX no espaço de trabalho PaaS.Call Download PBIX API from PaaS workspace.
  3. Salve o PBIX.Save PBIX.
  4. Chame Importar PBIX para o espaço de trabalho SaaS.Call Import PBIX to SaaS workspace.
  5. Atualize a cadeia de conexão chamando – POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnectionsUpdate connection string by calling - POST https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.SetAllConnections
  6. Obtenha a ID GW e a ID da fonte de dados chamando – GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSourcesGet GW id and datasource id by calling - GET https://api.powerbi.com/v1.0/myorg/datasets/{dataset_id}/Default.GetBoundGatewayDataSources
  7. Atualize as credenciais do usuário chamando – 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}

Relatórios e conjunto de dados antigosOld dataset & reports

Esses são os conjuntos de dados/relatórios criados antes de outubro de 2016.These are datasets/reports created before October 2016. Baixar PBIX não dá suporte a PBIXs carregados antes de outubro de 2016Download PBIX doesn't support PBIXs which were uploaded before October 2016

FluxoFlow

  1. Obtenha o PBIX do seu ambiente de desenvolvimento (seu controle do código-fonte interno).Get PBIX from your development environment (your internal source control).
  2. Chame Importar PBIX para o espaço de trabalho SaaS.Call Import PBIX to SaaS workspace.

Enviar relatório e conjunto de dados por pushPush Dataset & report

Baixar PBIX não dá suporte a conjuntos de dados API Push.Download PBIX doesn't support Push API datasets. O conjunto de dados de API por push não podem ser portados do PaaS para o SaaS.Push API dataset data can't be ported from PaaS to SaaS.

FluxoFlow

  1. Chame a API “Criar conjunto de dados” com o Json do conjunto de dados para criar conjunto de dados no espaço de trabalho do SaaS.Call "Create dataset" API with dataset Json to create dataset in SaaS workspace.
  2. Recrie o relatório para o conjunto de dados criado *.Rebuild report for the created dataset*.

É possível usar algumas soluções alternativas para migrar o relatório de api por push do PaaS para o SaaS fazendo o seguinte.It is possible using some workarounds to migrate the push api report from PaaS to SaaS by trying the following.

  1. Carregando o PBIX fictício para o espaço de trabalho do PaaS.Uploading some dummy PBIX to PaaS workspace.
  2. Clone o relatório de api por push e associe-o ao PBIX fictício da etapa 1.Clone the push api report and bind it to the dummy PBIX from step 1.
  3. Baixe o relatório de API por push com o PBIX fictício.Download push API report with the dummy PBIX.
  4. Carregue o PBIX fictício para seu espaço de trabalho do SaaS.Upload dummy PBIX to your SaaS workspace.
  5. Crie um conjunto de dados por push em seu espaço de trabalho do SaaS.Create push dataset in your SaaS workspace.
  6. Associe novamente o relatório ao conjunto de dados de api por push.Rebind report to push api dataset.

Criar e carregar novos relatóriosCreate and upload new reports

Além do conteúdo que você migrou do serviço do Azure do Power BI Embedded, é possível criar seus relatórios e conjuntos de dados usando o Power BI Desktop e depois publicar esses relatórios em um espaço de trabalho do aplicativo.In addition to the content you migrated from the Power BI Embedded Azure service, you can create your reports and datasets using Power BI Desktop and then publish those reports to an app workspace. O usuário final que publicar os relatórios precisará ter uma licença Power BI Pro para publicar em um espaço de trabalho do aplicativo.The end user publishing the reports need to have a Power BI Pro license in order to publish to an app workspace.

Recriar seu aplicativoRebuild your application

  1. Você precisará modificar seu aplicativo para usar as APIs REST do Power BI e o local do relatório em powerbi.com.You will need to modify your application to use the Power BI REST APIs and the report location inside powerbi.com.
  2. Recrie sua autenticação AuthN/AuthZ usando a conta mestre do seu aplicativo.Rebuild your AuthN/AuthZ authentication using the master account for your application. Você pode tirar proveito do uso de um token de inserção para permitir que esse usuário atue em nome de outros usuários.You can take advantage of using an embed token to allow this user to act on behalf of other users.
  3. Insira seus relatórios de powerbi.com em seu aplicativo.Embed your reports from powerbi.com into your application.

Mapear os usuários para um usuário do Power BIMap your users to a Power BI user

No aplicativo, você mapeará os usuários que gerencia dentro do aplicativo para uma credencial mestre do Power BI para a finalidade do seu aplicativo.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. As credenciais desta conta mestre do Power BI serão armazenadas dentro do seu aplicativo e serão usadas para criar tokens de inserção.The credentials for this Power BI master account will be stored within your application and be used to creating embed tokens.

O que fazer quando você estiver pronto para a produçãoWhat to do when you are ready for production

Quando estiver pronto para passar para a produção, você precisará fazer o seguinte.When you are ready to move to production, you will need to do the following.

  • Se você estiver usando um locatário separado para desenvolvimento, então será preciso certificar-se de que seus espaços de trabalho do aplicativo, juntamente com dashboards e relatórios, estão disponíveis em seu ambiente de produção.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. Também será preciso certificar-se de ter criado o aplicativo no Azure AD para seu locatário de produção e ter atribuído as permissões de aplicativo adequadas conforme indicado na Etapa 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.
  • Adquira uma capacidade que atenda às suas necessidades.Purchase a capacity that fits your needs. Para entender melhor a quantidade e o tipo de capacidade necessários, confira o White paper de planejamento de capacidade de análise inserida.To better understand how the amount and type of capacity you neeed, see the Embedded analytics capacity planning whitepaper. Você pode adquirir capacidade no Azure.You can purchase capacity in Azure.
  • Edite o espaço de trabalho do aplicativo e atribua-o a uma capacidade Premium em avançado.Edit the App workspace and assign it to a Premium capacity under advanced.

  • Implante seu aplicativo atualizado para a produção e comece a inserir relatórios do serviço do Power BI.Deploy your updated application to production and begin embedding reports from the Power BI service.

Após a migraçãoAfter migration

Você deve fazer uma limpeza no Azure.You should do some cleanup within Azure.

  • Remova todos os espaços de trabalho da solução implantada dentro do serviço do Azure do Power BI Embedded.Remove all workspaces off of the deployed solution within the Azure service of Power BI Embedded.
  • Exclua todas as Coleções de Espaço de trabalho que existam no Azure.Delete any Workspace Collections that exist within Azure.

Próximas etapasNext steps

Inserindo com o Power BIEmbedding with Power BI
Ferramenta de migração do Power BI EmbeddedPower BI Embedded migration tool
Trechos de código para migrar conteúdo do Power BI EmbeddedCode snippets for migrating content from Power BI Embedded
Como inserir seus dashboards, relatórios e blocos do Power BIHow to embed your Power BI dashboards, reports and tiles
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 de planejamento de capacidade de análise inseridaEmbedded analytics capacity planning whitepaper
White paper do Power BI PremiumPower BI Premium whitepaper

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