Partilhar via


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 painéis, compartilhados com outros usuários e acessados entre plataformas em aplicativos móveis do Power BI.

Power BI Desktop.

Pré-requisitos

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

  • Transfira e instale o Power BI Desktop, que é uma aplicação gratuita que é executada no seu computador local. Você pode baixar a área de trabalho do Power BI aqui.
  • Um ambiente 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 de criador, como personalizador de sistema ou criador de ambiente.
  • Tem de ter a licença adequada do Power BI para criar e partilhar relatórios do Power BI.
  • Para usar o conector Dataverse, a configuração Habilitar ponto de extremidade TDS deve estar ativada no seu ambiente. Mais informações: Gerir definições de funcionalidades

Observação

A maioria dos servidores proxy não manipula os dados do protocolo TDS (Tabular Data Stream) usado pelo conector Dataverse para Power BI.

Conectar-se ao Dataverse usando um conector

  1. Abra Power BI Desktop. Selecione Obter dados de outras fontes.
  2. Na lista Obter Dados , selecione Dataverso e, em seguida, selecione Conectar.
  3. Se lhe for pedido, selecione ou introduza as suas credenciais de utilizador e, em seguida, selecione Ligar.
  4. A lista de ambientes Power Platform com Dataverse é exibida. Na lista de ambientes, expanda o ambiente desejado, selecione as tabelas desejadas e selecione Carregar.
  5. Selecione uma das seguintes opções do modo de conectividade de dados :
    • Importar: recomendamos que importe dados para o Power BI sempre que possível. Com esse modo, os dados são armazenados em cache no serviço do Power BI e importados em um intervalo agendado.
    • DirectQuery: Conecta-se diretamente aos dados no Dataverse. Use este modo para recuperação de dados em tempo real. Esse modo também pode impor com mais rigor o modelo de segurança Dataverse. Para obter mais informações: Orientação do modelo DirectQuery no Power BI Desktop.
  6. Selecione OK. Poderá ser-lhe pedido para iniciar sessão utilizando as mesmas credenciais que utiliza para ligar às Power Apps e ao Dataverse. Selecione Conectar.

Importante

Para usar o conector Dataverse, as portas TCP 1433 e/ou 5558 precisam estar abertas para se conectar. Se apenas a porta 5558 estiver habilitada, você deverá acrescentar esse número de porta à URL do ambiente, como yourenvironmentid.crm.dynamics.com,5558.

Criar relatórios usando tabelas 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úmero de funcionários . No painel Visualizações , selecione Gráfico de pizza. Essas seleções adicionam uma nova visualização à tela do relatório.

Visualização do Power BI Desktop.

Tipos especiais de colunas

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 utilizar um conector do Dataverse, as colunas de escolha são apresentadas como duas colunas a mostrar o valor exclusivo e o valor do item de apresentação.

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

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

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

    approvalstatus approvalstatusname
    1 Submetido
    2 Em Revisão
    3 Aprovado
    4 Rejeitado

Colunas de nome de escolha e de impacto de desempenho

Ao recuperar o nome do rótulo para uma coluna de escolha, o Dataverse faz uma associação com a tabela interna stringmap (onde os rótulos localizados são armazenados). Isso é executado para cada coluna de rótulo/nome. Note que esta união e a realização de filtros contra a coluna de nome de etiqueta, em vez da coluna de valor, pode afetar significativamente o desempenho da consulta do relatório.

Colunas de opções

As opções são semelhantes às colunas de escolha, com a diferença de que os usuários podem selecionar vários itens da lista. Atualmente, as opções não são totalmente suportadas com o conector Dataverse. Quando você usa o conector Dataverse com colunas de opções, você recebe apenas os valores inteiros, que são separados por vírgula. As colunas de nome de etiqueta do item não são devolvidas. Para obter mais informações sobre os tipos de dados Dataverse não suportados com o conector Dataverso, consulte Operações e tipos de dados suportados.

Lookups

As colunas de pesquisa utilizam relação entre tabelas de muitos-para-um (N: 1) entre a tabela em que está a trabalhar e 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.

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

Embora alguns relacionamentos possam ser criados automaticamente, você ainda pode revisar e garantir que os relacionamentos corretos sejam estabelecidos 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 da área de trabalho do Power BI, você criaria uma nova relação entre sua coluna de pesquisa e a coluna ID na tabela relacionada.

Encontre o URL do seu ambiente

  1. Abra Power Apps, selecione o ambiente ao qual vai ligar, selecione Definições no canto superior direito e, em seguida, selecione Detalhes da sessão.

    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 do seu ambiente. O URL está no formato: https://yourenvironmentid.crm.dynamics.com/. Mantenha isso em algum lugar à mão para que você possa usá-lo ao criar seus relatórios do Power BI.

Solução de problemas

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

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

Mensagem de erro excedida o limite de registro TLS. Para contornar esse limite, otimize a consulta adicionando filtros e soltando colunas para que a consulta retorne menos dados.

Alternativa para um número muito grande de colunas de procuras ou de escolha

Se a mensagem de erro ocorrer no Power BI quando você tenta se conectar a uma tabela com um número muito grande de pesquisas ou colunas de escolha, a seguinte solução manual pode permitir que você se conecte à tabela. A conta, o contacto e a tabela de oportunidades podem enfrentar este problema quando são extensivamente personalizados com pesquisas adicionais ou colunas de escolha.

Conecte-se 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 Origem>Consulta em Branco.

  3. Atribua um nome à 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 da 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 outras colunas necessárias.

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

  10. Quando solicitado, selecione Direct Query para a nova consulta.

A consulta agora pode ser usada no relatório.

Mensagem de erro: Incapaz de conectar (provedor Named Pipes Provider, erro: 40 – Não foi possível estabelecer uma conexão com o SQL Server)

Quando essa mensagem de erro ocorre, o conector não consegue conectar-se ao ponto de extremidade TDS. Isso pode ocorrer quando a URL usada com o conector inclui https:// e/ou a terminação /.

Mensagem de erro: Não foi possível conectar. Remova o prefixo https:// e a barra final para que o 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 TDS, consulte Solução de problemas de conexão.

Consulte também

Utilizar modelos compostos no Power BI Desktop

Exibir dados da tabela Dataverse for Teams no Power BI Desktop