Perguntas frequentes sobre o Power BI Embedded

O PBIE (Microsoft Power BI Embedded) permite que os desenvolvedores de aplicativos insiram relatórios incríveis e totalmente interativos em aplicativos, sem precisar criar controles e visualizações de dados desde o início.

Os desenvolvedores e as empresas de software, também como ISVs (fornecedores independentes de software), codificam os aplicativos.

O Power BI é uma solução de análise de software como serviço que fornece às organizações uma exibição única dos dados corporativos mais críticos.

A Microsoft desenvolveu o Power BI Embedded para ISVs que desejam inserir visuais em seus aplicativos para ajudar seus clientes a tomar decisões analíticas. Isso poupa os ISVs de precisar criar suas próprias soluções analíticas. A análise integrada permite que os usuários empresariais acessem os dados corporativos e executem consultas para gerar insights no aplicativo.

A capacidade do Power BI Premium é direcionada a empresas que desejam uma solução de BI completa para fornecer uma exibição única da organização, dos parceiros, dos clientes e dos fornecedores. O Power BI Premium ajuda a organização na tomada de decisões. O Power BI Premium é um produto SaaS que permite aos usuários consumir conteúdo por meio do portal do Power BI, de aplicativos móveis e de aplicativos desenvolvidos internamente.

O Power BI Embedded é para ISVs que desejam inserir visuais em seus aplicativos. O Power BI Embedded ajuda os clientes a tomar decisões por ser destinado aos desenvolvedores de aplicativos, de modo que os clientes desses aplicativos, incluindo qualquer pessoa dentro ou fora da organização, podem consumir o conteúdo armazenado na capacidade do Power BI Embedded. Não é possível compartilhar o conteúdo da capacidade do Power BI Embedded por meio de publicação com um clique na Web nem no SharePoint.

A Microsoft recomenda que as empresas comprem o Power BI Premium, uma solução de BI de nuvem de autoatendimento e nível empresarial. É recomendável que os ISVs comprem o Power BI Embedded para seus componentes de análise integrada habilitados para nuvem. No entanto, um cliente não tem restrição sobre qual produto comprar.

Pode haver alguns casos em que um ISV (normalmente de grande porte) deseja usar uma SKU P para obter os benefícios extras do serviço do Power BI predefinido na organização, bem como inseri-la nos aplicativos.

Para saber mais sobre as diferenças entre Embedded Premium, confira Qual SKU devo usar.

Os tokens inseridos com a licença Pro ou PPU (Premium por usuário) destinam-se para teste de desenvolvimento, portanto, uma conta mestre ou entidade de serviço do Power BI pode gerar apenas um número limitado de tokens. Compre uma capacidade para inserir em um ambiente de produção. Não há limites para a quantidade de tokens inseridos que você pode gerar ao comprar uma capacidade. Em testes de desenvolvimento, você pode usar tokens de avaliação de inserção gratuitos com uma licença Pro. Para fazer uma inserção em um ambiente de produção, você deve comprar uma capacidade.

As capacidades Embedded Premium não fornecem um recurso de dimensionamento automático vertical pronto para uso. Para saber mais sobre opções alternativas de dimensionamento automático para capacidades Embedded Premium, confira [Dimensionamento automático no Embedded (./azure-pbie-scale-capacity.md#autoscale-your-capacity).

O Power BI Embedded Premium avalia o nível de utilização agregando registros de uso a cada 30 segundos. Cada avaliação é composta por duas agregações diferentes: utilização interativa e utilização em segundo plano.

A utilização interativa é avaliada considerando todas as operações interativas que foram concluídas no ciclo de avaliação de meio minuto atual ou próximo a ele.

A utilização em segundo plano é avaliada considerando todas as operações em segundo plano concluídas nas últimas 24 horas, em que cada operação em segundo plano contribui com apenas 1/2880 de seu custo total de CPU (existem 2880 ciclos de avaliação em cada período de 24 horas).

Uma capacidade consiste em um número definido de núcleos virtuais. O aplicativo Métricas de Capacidade do Microsoft Fabriccontrola a utilização dos núcleos virtuais da sua capacidade. O uso da CPU informado no aplicativo impulsiona a necessidade de dimensionamento automático.

Se você tiver uma capacidade A1 com um v-core, cada cota de ciclo de avaliação será de 30 segundos (1*30) de utilização da CPU. Se a soma de sua utilização de CPU exceder a cota total de v-core em sua capacidade, esta entrará em um modo de atraso de solicitação interativa temporário, durante o qual cada solicitação interativa (como carregamento de relatório, interação visual etc.) será atrasada antes do envio ao mecanismo para execução. A quantidade de atraso é proporcional à quantidade de sobrecarga detectada. A sobrecarga de 100% gerará um atraso de 20 segundos, enquanto sobrecargas menores que 10% são permitidas.

A capacidade permanecerá no modo de atraso de solicitação interativa se a avaliação anterior for maior que 100% de uso de recursos.

Os seguintes eventos são operações interativas:

• Conjuntos de dados - Visualização de relatório, consulta, leitura de XMLA
• Fluxos de dados
• Relatório paginado - renderização de relatório paginado

Estas são operações em segundo plano:

• Conjuntos de dados – atualização agendada, atualização sob demanda, consulta em segundo plano (após atualização)
• Fluxos de dados – atualização agendada do fluxo de dados
• Relatórios paginados - renderizações de assinaturas baseadas em dados
• IA

Seu conjunto de dados do relatório de métricas retém de 30 a 45 dias de dados. Você pode usar o relatório para indicar o nível de proximidade dos recursos máximos de sua capacidade e, se salvar instantâneos mensais, poderá compará-los para indicar tendências de crescimento e extrapolar a taxa na qual chegará a 100% de utilização de seu recursos.

Há duas opções para Embedded Premium:

• A página de Gerenciamento de capacidade no portal de administração do Power BI i tem uma caixa de seleção de notificação de utilização. Os usuários podem selecionar o limite no qual um alerta será disparado (o padrão é 80%) e o endereço de email para o qual os alertas de utilização deverão ser enviados.
• Configure um Alerta do Azure usando a métrica de CPU Premium.

O serviço do Power BI armazena mais de 90 dias de dados de utilização. Os usuários que precisam de retenção de dados mais longa podem usar BYOLA (Traga sua Própria Licença) para armazenar mais dados de utilização, que estarão disponíveis para clientes do Embedded Premium na data de GA (disponibilidade geral) do Embedded Premium.

No lado esquerdo do relatório de utilização, um visual de gráfico de barras exibe informações de utilização entre workspaces para o período do relatório. Esse visual de gráfico de barras pode ser usado para estornos, desde que cada workspace represente uma unidade de negócios, centro de custo ou outra entidade diferente à qual os estornos podem se aplicar.

Confira o artigo Capacidade e SKUs na análise integrada do Power BI.

• Entre no seu diretório organizacional (não compatível com contas Microsoft).
• Você precisa ter um locatário do Power BI, isto é, pelo menos um usuário em seu diretório deve estar inscrito no Power BI.
• Você precisa ter uma assinatura do Azure em seu diretório organizacional.

• Usando o portal do administrador do Power BI.

• Baixando o aplicativo Métricas de Capacidade do Microsoft Fabric no Power BI.

• Usando a criação de log de diagnóstico do Azure.

Embora não haja dimensionamento automático no momento, todas as APIs estão disponíveis para dimensionamento a qualquer momento.

O provisionamento da capacidade (dimensionar/retomar/criar) pode falhar. É possível usar a API Obter detalhes para verificar o ProvisioningState de uma capacidade: Capacidades – Obter detalhes.

Com o recurso Multi-Geo, você pode comprar uma capacidade do Power BI Embedded em uma região diferente da localização do seu locatário da página inicial do Power BI

Quando um usuário recebe permissões para um workspace, aplicativo ou item, ele pode não ser imediatamente disponibilizado por meio de chamadas à API. O resultado pode ser um item ausente em uma resposta da API 'GET' ou um erro ao tentar usar o item. O usuário pode resolver esse problema chamando a API refreshUserPermissions, que atualiza as permissões de usuário.

Você pode usar o portal do PBI para localizar sua região de locatário do PBI.

https://app.powerbi.com/> ? > Sobre o Power BI

• É possível criar o PBIE para seu locatário com o tipo de assinatura CSP
• A conta de parceiro pode ser conectada ao locatário do cliente e comprar o PBIE para o locatário do cliente, especificando o usuário do locatário do cliente como administrador de capacidade do Power BI

O Power BI exige que você se inscreva com uma conta organizacional. Não é possível tentar se inscrever no Power BI usando uma conta Microsoft.

Sim, há cmdlets do PowerShell e APIs REST do Azure Resource Manager que você pode usar para criar e gerenciar recursos de PBIE.

• APIs REST
• Cmdlets do PowerShell

Para promover sua solução para produção, é preciso atribuir o conteúdo do Power BI (workspace) que seu aplicativo usa a uma capacidade do Power BI Embedded (uma SKU).

O Power BI Embedded não é regional. Isso significa que ele não depende de nenhuma região específica do Azure.

Confira Produtos do Azure por região para obter informações regionais sobre todos os produtos do Azure.

O Power BI Embedded continua usando o Microsoft Entra ID para autenticação do usuário mestre (um usuário licenciado designado do Power BI Pro ou do PPU (Premium por usuário)) ou a entidade de serviço para autenticar o aplicativo dentro do Power BI.

Um ISV pode implementar suas próprias autenticação e autorização para seus aplicativos.

Se já tiver um locatário do Microsoft Entra, você poderá usar seu diretório existente. Você também pode criar um novo locatário do Microsoft Entra para segurança de conteúdo do aplicativo inserido.

Para obter um token do Microsoft Entra, use uma das Bibliotecas de Autenticação da Microsoft. Bibliotecas de cliente estão disponíveis para várias plataformas.

A ID de objeto na tela principal de um aplicativo registrado é a ID de objeto para o aplicativo.

A ID de objeto encontrada na seção Aplicativo gerenciado no diretório local > Propriedades é a ID de objeto de entidade de serviço que você precisa usar. Essa ID de objeto é para fazer referência a uma entidade de serviço para operações ou fazer alterações na ID de objeto da entidade de serviço. Como aplicar uma entidade de serviço como um administrador a um workspace.

É necessário ter uma conta do Power BI antes de comprar o Power BI Embedded no Azure. A região implantada do Power BI Embedded determina sua conta do Power BI. Gerencie o recurso do Power BI Embedded no Azure para:

• Aumentar/reduzir
• Adicionar administradores de capacidade
• Pausar/retomar serviço

Use o PowerBI.com para atribuir/cancelar a atribuição de workspaces à capacidade do Power BI Embedded.

Muitas vezes há confusão sobre quando usar filtros RLS versus filtros JavaScript. Um método destina-se a controlar o que um usuário específico pode ver e o outro destina-se a otimizar a visualização do usuário.

Com o RLS, o desenvolvedor ISV controla a filtragem de dados como parte da criação do modelo e da geração de tokens inseridos. O usuário final vê apenas o que o ISV permitir. Neste caso, o usuário pode optar por ver menos do que o que está sendo filtrado, mas não conseguirá ignorar a configuração de RLS e ver mais do que o permitido.

Com a filtragem do lado cliente (JavaScript ), o ISV pode decidir o que o usuário final vê na exibição inicial, mas não pode controlar as alterações que o usuário final pode aplicar à própria exibição. Como o código do cliente JavaScript do usuário pode disparar a filtragem de dados no back-end, ele não pode ser considerado seguro.

Depois que você habilita a entidade de serviço para ser usada com o Power BI, as permissões do AD do aplicativo não estarão mais em vigor. As permissões do aplicativo então são gerenciadas por meio do portal de administração do Power BI.

As entidades de serviço herdam as permissões para todas as configurações de locatário do Power BI de seu grupo de segurança. Para restringir permissões, crie um grupo de segurança dedicado para entidades de serviço e adicione-o à lista Exceto grupos de segurança específicos para as configurações relevantes habilitadas do Power BI.

Essa situação é importante quando você adiciona a entidade de serviço como um admin ao novo workspace. Você pode gerenciar essa tarefa por meio de APIs ou com o serviço do Power BI.

A ID do aplicativo , também conhecida como ID do cliente, é usada para criar o token de acesso ao passar a ID do aplicativo para autenticação.

Para fazer referência a uma entidade de serviço para operações ou fazer alterações, você usa a ID de objeto de entidade de serviço – por exemplo, aplicação de uma entidade de serviço como um administrador a um workspace.

Para inserir um relatório do Power BI que contém um visual de relatório paginado com o método Inserir para seus clientes, use uma entidade de serviço e insira o relatório com um token de inserção de vários recursos, que contém o seguinte:

• ID do relatório do Power BI
• ID do relatório paginado (do relatório ao qual o visual está conectado)
• ID do conjunto de dados (do relatório do Power BI)

A entidade de serviço deve ter acesso a ambos os relatórios (paginado e do Power BI). Exemplo de corpo da solicitação para a chamada gerar token:

{
  "datasets": [
    {
      "id": "a5d577c7-0568-4180-a6d3-0f6cc0ca3df4"
    }
  ],
  "reports": [
    {
      "allowEdit": false,
      "id": "05024421-b4df-483c-a2ce-61202d0323ce"
    },
    {
      "id": "f8612306-f3a8-40e1-a448-d8e05992a007"
    }
  ]
}

Não, você não pode entrar no Power BI usando a entidade de serviço.

Além disso, você não pode consumir conteúdo como usuário em aplicativos externos (SaaS inserido), apenas ao gerar um token inserido.

Desempenho do Power BI Embedded

O Power BI Embedded está disponível por meio do Azure.

Os clientes continuam a pagar pelas compras existentes do Power BI Premium até o término do prazo do contrato atual e, então, podem mudar as compras do Power BI Premium conforme necessário naquele momento.

Não, o Power BI Embedded inclui a capacidade baseada no Azure de que você precisa para implantar e distribuir sua solução aos clientes.

Os clientes podem alterar o uso a cada hora. Não há nenhum compromisso mensal nem anual pelo serviço do Power BI Embedded.

O Power BI Embedded é cobrado em uma taxa por hora previsível com base nos tipos de nós implantados. A cobrança será feita enquanto o recurso estiver ativo, mesmo que não haja uso. Você precisa pausar o recurso para interromper a cobrança.

Você precisa de uma licença Power BI Pro ou PPU (Premium por usuário) ou de uma entidade de serviço para usar APIs REST. Para adicionar relatórios a um workspace do Power BI, um analista precisa de uma licença Power BI Pro ou PPU (Premium por usuário) ou de uma entidade de serviço. Para gerenciar o locatário e a capacidade do Power BI, um administrador precisará ter uma licença Power BI Pro ou PPU (Premium por usuário).

Como o Power BI Embedded permite o uso do portal do Power BI para gerenciar e validar o conteúdo inserido, a licença Power BI Pro ou PPU (Premium por usuário) é necessária para autenticar o aplicativo no PowerBI.com para obter acesso aos relatórios nos repositórios corretos.

No entanto, para a criação/edição de relatórios inseridos dentro do seu aplicativo, o usuário final não precisa ter uma licença Pro ou PPU (Premium por usuário), pois ele não precisa ser um usuário do Power BI.

Sim. Você pode usar os créditos Azure para o Power BI Embedded.

Como o Power BI Embedded faz parte do Azure, é possível usar o serviço com o crédito de US$ 200 recebido durante a inscrição no Azure.

O Power BI Embedded também está disponível para as nuvens nacionais/regionais.

Não há preço especial do Azure para entidades sem fins lucrativos e educacionais.

A Coleção de Workspaces do Power BI (Power BI Embedded versão 1) é uma solução baseada no recurso de Coleção de Workspaces do Power BI do Azure. Essa solução permite criar aplicativos do Power BI Embedded para seus clientes usando conteúdo do Power BI na solução Coleção de workspaces do Power BI, APIs dedicadas e chaves de coleção de workspaces para autenticar o aplicativo no Power BI.

Sim, mas os clientes que já estão usando a solução Coleção de Workspaces do Power BI podem continuar usando-a até que seja preterida. Os clientes também podem criar novas coleções de workspaces e qualquer aplicativo do Power BI Embedded que ainda usa a Coleção de Workspaces do Power BI.

No entanto, isso também significa que os novos recursos não são adicionados a soluções de Coleção de Workspaces do Power BI. Incentivamos os clientes a planejar sua migração para a nova solução Power BI Embedded.

Os clientes que já usam a solução Coleções de Workspace do Power BI podem continuar usando-a até o término do contrato de suporte.

As regiões disponíveis são Sudeste da Austrália, Sul do Brasil, Canadá Central, Leste dos EUA 2, Leste do Japão, Centro-Norte dos EUA, Norte da Europa, Centro-Sul dos EUA, Sudeste Asiático, Sul do Reino Unido, Europa Ocidental, Oeste da Índia e Oeste dos EUA.

Há recursos e funcionalidades na solução Power BI Embedded que não podem ser usados com a Coleção de Workspaces do Power BI.

Alguns deles são:

• Todas as fontes de dados do PBI são compatíveis. Apenas duas fontes de dados da Coleção de Workspaces do Power BI são compatíveis.
• Os recursos como P e R, atualizar, indicadores, inserção de dashboards e peças, menu personalizado, entre outros, só têm suporte na solução Power BI Embedded.
• Modelo de cobrança por capacidade.

A Ferramenta de configuração de inserção permite iniciar rapidamente e baixar um aplicativo de exemplo para começar a inserção com o Power BI.

• A inserção para clientes fornece a capacidade de inserir os dashboards e relatórios para usuários que não têm uma conta do Power BI. Na Ferramenta de configuração de inserção, execute a solução Inserir para os clientes.
• A inserção para a organização permite que você estenda o serviço do Power BI. Na Ferramenta de configuração de inserção, execute a solução Inserir para a organização.

Se você estiver trabalhando com a experiência Inserir para clientes, salve e descompacte o arquivo PowerBI-Developer-Samples.zip. Em seguida, abra a pasta PowerBI-Developer-Samples-master\App Owns Data e execute o arquivo PowerBIEmbedded_AppOwnsData.sln.

Se você estiver trabalhando com a experiência Inserir para a organização, salve e descompacte o arquivo PowerBI-Developer-Samples.zip. Em seguida, abra a pasta PowerBI-Developer-Samples-master\User Owns Data\integrate-report-web-app e execute o arquivo pbi-saas-embed-report.sln.

Para saber como editar aplicativos registrados do Microsoft Entra, consulte Início Rápido: Atualizar um aplicativo no Microsoft Entra ID.

Você pode aprender a editar os dados do Power BI aqui.

Para saber mais, veja Solução de problemas de seu aplicativo inserido.

Mais perguntas? Experimente a Comunidade do Power BI