Configurar o Power BI Embedded
APLICA-SE A: Os dados pertencem ao aplicativo Os dados pertencem ao usuário
Para começar a usar Power BI Embedded a fim de compartilhar seus relatórios com outras pessoas, use a Ferramenta de configuração de análise integrada do Power BI para começar. Este artigo mostra como fazer isso.
Para usar a análise integrada do Power BI, você precisa registrar um aplicativo do Microsoft Entra no Azure. O aplicativo do Microsoft Entra estabelece permissões para os recursos REST do Power BI e permite o acesso às APIs REST do Power BI.
Pré-requisito
Para configurar um ambiente de análise integrada do Power BI, você precisa de um dos seguintes itens:
- Locatário do Microsoft Entra e um usuário organizacional (mestre)
- Conta do Power BI Pro
Antes de começar
Antes de registrar seu aplicativo, decida qual das seguintes soluções melhor atende às suas necessidades:
Inserir para seus clientes
Use a solução inserir para seus clientes, também conhecida como dados de propriedade do aplicativo, se você criar um aplicativo projetado para seus clientes. Os usuários não precisam entrar ou ter uma licença do Power BI para usar seu aplicativo. Seu aplicativo é autenticado no Power BI usando uma conta de usuário mestre (uma licença de Power BI Pro usada para fazer login nele) ou uma entidade de serviço.
Geralmente, a solução de inserção para seus clientes é usada por ISVs (fornecedores independentes de software) e por desenvolvedores criando aplicativos para terceiros.
Inserir para a organização
Use a solução inserir a sua organização, também conhecida como o usuário tem dados, se criar um aplicativo que exigirá que os usuários usem suas credenciais para autenticação no Power BI.
Geralmente, a solução de inserção para a organização é usada por empresas e grandes organizações e é destinada a usuários internos.
Para obter mais informações sobre as duas soluções, confira O que são as soluções de análise integrada do Power BI?.
Configure seu ambiente
Depois de entender as duas opções de inserção, você pode usar a ferramenta de instalação para criar seu ambiente do Power BI Embedded.
Se preferir configurar manualmente seu ambiente, pule as etapas nas seções a seguir. Em vez disso, siga as etapas em Registro manual, posteriormente neste artigo.
Importante
Se você está inserindo um GCC, siga as instruções em Registro manual.
Para usar a ferramenta para configurar seu ambiente, acesse a ferramenta de Configuração de análise integrada do Power BI. Selecione a opção de inserção desejada.
Etapa 1 – Entrar no Power BI
Em Etapa 1 na ferramenta de instalação, selecione Entrar. Essa etapa o conectará ao Power BI. Se for solicitado que você escolha uma conta, entre com um usuário que pertença ao seu locatário do Power BI. O aplicativo do Microsoft Entra é registrado para esse usuário.
Observação
Se já está conectado, confirme se você entrou com o usuário que deseja usar para criar o aplicativo Microsoft Entra. Para alterar os usuários, selecione sair. Depois que a ferramenta for reiniciada, entre com o usuário correto.
Escolha Avançar para passar para a próxima etapa.
Etapa 2 – Registrar seu aplicativo
Nessa etapa, você registrará um aplicativo Microsoft Entra no Azure. O aplicativo do Microsoft Entra estabelece permissões para os recursos REST do Power BI e permite o acesso às APIs REST do Power BI. Você pode alterar essas configurações posteriormente quando quiser.
Para registrar seu aplicativo para seus clientes, preencha os seguintes campos:
Nome do aplicativo – dê um nome ao aplicativo.
Acesso à API – selecione as APIs do Power BI (também conhecidas como escopos) de que o aplicativo precisa. Use Selecionar Tudo para selecionar todas as APIs. Para obter mais informações sobre permissões de acesso do Power BI, consulte Permissões e consentimento no ponto de extremidade da plataforma de identidade da Microsoft.
Selecione Registrar.
A ID do Aplicativo de seu aplicativo do Microsoft Entra é exibida na caixa Resumo. Copie o valor para uso posterior.
Etapa 3 – Criar um workspace (opcional)
Crie um workspace no serviço do Power BI:
Se já tiver um workspace do Power BI, selecione Ignorar.
Para criar um workspace, dê um nome para ele e selecione Criar workspace. O nome e a ID do workspace aparecem na caixa Resumo. Copie esses valores para uso posterior.
Dica
Para que o aplicativo de amostra de análise integrada funcione conforme o esperado, você deve usar a ferramenta para criar um workspace.
Etapa 4 – Importar conteúdo (opcional)
Selecione uma das seguintes opções:
Se tiver seu próprio aplicativo do Power BI, você poderá selecionar Ignorar.
Para criar um aplicativo de exemplo do Power BI usando um relatório de exemplo, selecione Relatório de exemplo do Power BI e selecione Importar.
Para criar um aplicativo de exemplo do Power BI usando seu próprio relatório, selecione Carregar um arquivo .pbix, pesquise pelo arquivo e selecione Importar.
Etapa 5 – conceder permissões (Inserir para seus clientes apenas)
Selecione Conceder permissões e, na caixa de diálogo, selecione Aceitar. Essa etapa permite que o aplicativo do Microsoft Entra acesse as APIs selecionadas (também conhecidas como escopos) com o usuário conectado. Esse usuário também é conhecido como usuário mestre.
Baixe o aplicativo de exemplo (opcional)
Se você criou um workspace do Power BI e carregou conteúdo nele usando a ferramenta, agora você pode selecionar Baixar aplicativo de exemplo.
Observação
Se tiver ignorado os estágios opcionais, você ainda poderá baixar um aplicativo de exemplo do Power BI. No entanto, o código no aplicativo baixado não possui as propriedades que são preenchidas durante o registro. Por exemplo, se você não criar um workspace, o aplicativo de exemplo não incluirá a ID dele.
Copie todas as informações na caixa Resumo. Seu ambiente de inserção do Power BI está pronto para uso.
Registro manual
Se você não usou a ferramenta de configuração de análise integrada do Power BI, use o procedimento nesta seção para registrar manualmente um aplicativo do Microsoft Entra. Essas etapas são destinadas somente a quem está uma das seguintes soluções:
- Um aplicativo inserir para a organização
- Um aplicativo inserir para os clientes com uma entidade de serviço
Para obter mais informações sobre como registrar aplicativos no Microsoft Entra ID, confira Registrar um aplicativo com a plataforma de identidade da Microsoft.
Entre no portal do Azure.
Selecione o locatário do Microsoft Entra selecionando sua conta no canto superior direito da página.
Selecione Registros do Aplicativo. Se não vir essa opção, pesquise por ela.
Em Registros de aplicativo, selecione Novo registro.
Preencha os campos a seguir:
Nome – dê um nome ao aplicativo.
Tipo de conta com suporte – selecione quem pode usar o aplicativo.
(Opcional) Na caixa URI de redirecionamento, adicione uma URL de redirecionamento.
Selecione Registrar. Após o aplicativo ser registrado, você é direcionado para a página de visão geral dele, em que pode obter a ID do Aplicativo.
Conteúdo relacionado
Mais perguntas? Experimente perguntar à Comunidade do Power BI.