Criar um relatório do Power BI usando dados do Dataverse

O Microsoft Dataverse permite que você se conecte diretamente aos seus dados usando o Power BI Desktop para criar relatórios e publicá-los no Power BI. No Power BI, os relatórios podem ser usados em dashboards, compartilhados com outros usuários e acessados entre plataformas em aplicativos móveis do Power BI.

Pré-requisitos

Para usar o Power BI com o Dataverse, você precisa dos seguintes itens:

• Baixe e instale o Power BI Desktop, que é um aplicativo gratuito que é executado em seu computador local. Você pode baixar o Power BI Desktop aqui.
• Um ambiente do Power Platform com os seguintes privilégios:
  • Para acessar dados em uma tabela, você deve ter privilégios de leitura para a tabela.
  • Para modificar uma tabela no Power Apps (make.powerapps.com), você deve ter uma função de segurança que inclua privilégios do criador, como o personalizador de sistema ou o criador de ambiente.
• Você deve ter a licença apropriada do Power BI para criar e compartilhar relatórios do Power BI.
• Para usar o conector do Dataverse, a configuração Habilitar ponto de extremidade TDS deve ser habilitada em seu ambiente. Mais informações: Gerenciar configurações de recursos

Conectar-se ao Dataverse usando um conector

Criar relatórios usando tabelas do Dataverse

Depois de carregar as tabelas usando um conector, você pode começar a criar relatórios ou repetir as etapas anteriores para adicionar tabelas adicionais. Por exemplo, no painel Colunas, selecione a coluna nome e, em seguida, selecione a coluna númerodefuncionários. No painel Visualizações, selecione Gráfico de Pizza. Essas seleções adicionam uma nova visualização à tela do relatório.

Tipos de colunas especiais

Colunas de escolha

As colunas de escolha são usadas em tabelas para fornecer uma lista suspensa de itens a um usuário para fazer uma única seleção em aplicativos e fluxos. Ao usar o conector do Dataverse, as colunas de opções são apresentadas como duas colunas para mostrar o valor exclusivo e o valor de item de exibição.

Por exemplo, se você tivesse uma coluna de escolha na tabela chamada approvalstatus, veria duas colunas no Power BI:

• approvalstatus - Esta coluna mostra um valor inteiro exclusivo para cada item de sua escolha. approvalstatus pode ajudar quando você aplica filtros para que os filtros não sejam afetados quando você fizer alterações futuras no nome de exibição.

• approvalstatusname - Esta coluna mostra o nome de exibição amigável do item e é mais usada ao apresentar a opção em uma tabela ou gráfico.

  approvalstatus	approvalstatusname
  1	Submitted
  2	Em Revisão
  3	Aprovada
  4	Rejected

Impacto no desempenho e colunas de nomes escolhidos

Ao recuperar o nome do rótulo para uma coluna de escolha, o Dataverse faz uma junção com a tabela interna stringmap (em que os rótulos localizados são armazenados). Isso é executado para cada coluna de rótulo/nome. Observe que essa junção e a criação de filtros na coluna de nome do rótulo, em vez da coluna de valor, podem afetar significativamente o desempenho da consulta de relatório.

Colunas de opções

As opções são semelhantes às colunas de escolha, com a diferença sendo que os usuários podem selecionar vários itens na lista. No momento, as opções não têm suporte total com o conector do Dataverse. Ao usar o conector do Dataverse com colunas de opções, você recebe apenas os valores inteiros, que são separados por vírgula. As colunas de nome do rótulo de item não são retornadas. Para obter mais informações sobre os tipos de dados do Dataverse que não são suportados pelo conector do Dataverse, consulte operações com suporte e tipos de dados.

Lookups

As colunas de pesquisa usam um relacionamento de tabela muitos para um (N:1) entre a tabela com a qual você está trabalhando e o tipo de linha de destino definido para a pesquisa. As pesquisas são apresentadas no Power BI Desktop como duas colunas lookupid e lookupid-name.

Navegando em relações

As relações no Dataverse exigem que você crie uma relação no Power BI Desktop entre as duas tabelas usando uma coluna GUID, esse é um identificador exclusivo gerado pelo sistema que garante que as relações sejam criadas para as linhas de criação em que a ambiguidade ou a duplicação possam existir com outras colunas. Você pode ler mais sobre como gerenciar relações no Power BI Desktop aqui.

Embora algumas relações possam ser criadas automaticamente, você ainda pode examinar e garantir que as relações corretas sejam estabelecidas ao criar seu relatório:

• A coluna de pesquisa na tabela contém o GUID da linha na tabela relacionada.
• A tabela relacionada tem uma coluna no formato "[tableName]ID" que contém o GUID, por exemplo Accountid ou MyCustomtableid
• Usando o recurso Gerenciar Relações do Power BI Desktop, você criaria uma nova relação entre a coluna de pesquisa e a coluna ID na tabela relacionada.

Localizar a URL do ambiente

1. Abra o Power Apps, selecione o ambiente ao qual você vai se conectar, selecione Configurações no canto superior direito e selecione Detalhes da sessão.

   

2. Na caixa de diálogo detalhes da sessão do Power Apps , selecione Copiar Detalhes.

3. Cole os detalhes da sessão em algum lugar, como o Bloco de Notas, para que você possa copiar apenas a URL da Instância. A URL da instância é a URL exclusiva para seu ambiente. A URL está no formato: https://yourenvironmentid.crm.dynamics.com/. Mantenha isso em algum lugar útil para que você possa usá-lo ao criar seus relatórios do Power BI.

Resolução de problemas

Mensagem de erro: O tamanho dos registros de retorno não pode exceder 83886080

Esse erro pode ocorrer com o conector do Dataverse quando você executa ou projeta um relatório com um conjunto de resultados maior que 80 MB. O TDS tem um limite de tamanho de conjunto de resultados de 80 MB.

Para contornar esse limite, otimize a consulta adicionando filtros e descartando colunas para que a consulta retorne menos dados.

Solução alternativa para um número muito grande de consultas ou colunas de escolha

Se a mensagem de erro ocorrer no Power BI quando você tentar se conectar a uma tabela com um número muito grande de pesquisas ou colunas de escolha, a solução alternativa manual a seguir poderá permitir que você se conecte à tabela. A conta, o contato e a tabela de oportunidades podem encontrar esse problema quando forem amplamente personalizados com pesquisas adicionais ou colunas de escolha.

Faça a conexão manualmente à tabela em um relatório do Power BI:

1. No Power BI Desktop com o relatório carregado, selecione Transformar Dados para carregar o Power Query.

2. Selecione Nova Fonte>Consulta em Branco.

3. Nomeie sua consulta.

4. Selecione Editor Avançado na guia Página Inicial do Power BI Desktop.

5. Substitua o texto da consulta por este texto de consulta.

   let
       Source = CommonDataService.Database("<myenvironment.crmX>.dynamics.com"),
       dbo_contact = Source{[Schema="dbo",Item="contact"]}[Data],
       #"selectedcolumns" = Table.SelectColumns(dbo_contact,{"fullname", "emailaddress1"})
   in
       #"selectedcolumns"
   

6. Substitua myenvironment.crmX no texto da consulta pelo valor do domínio do ambiente, como contoso.crm4.

7. Selecione Concluído.

8. Selecione Escolher colunas para adicionar colunas adicionais necessárias.

9. Selecione Fechar e Aplicar para salvar alterações de modelo.

10. Quando solicitado, selecione Consulta Direta para a nova consulta.

A consulta agora pode ser usada no relatório.

Mensagem de erro: não é possível conectar-se ao SQL Server (provedor Named Pipes Provider, erro: 40 – Não foi possível abrir uma conexão com o SQL Server)

Quando essa mensagem de erro ocorre, o conector falha em se conectar ao endpoint TDS. Isso pode ocorrer quando a URL usada com o conector inclui https:// e/ou o final /.

Remova o https:// e a barra final para que a URL esteja no formato orgname.crm.dynamics.com.

Solução de problemas de conexão

Para obter informações sobre como solucionar problemas de conexão ao usar o ponto de extremidade do TDS, consulte Solução de problemas de conexão.

Consulte também

Usar modelos compostos no Power BI Desktop

Exibir dados de tabela do Dataverse for Teams no Power BI Desktop