Power BI: Recuperar dados de um modelo de dados do CDF

Conecte um modelo de dados do Cognite Data Fusion (CDF) como uma fonte de dados e use o Power BI para consultar, transformar e visualizar os dados do CDF.

informações

Antes de fazer login com a ID da organização e recuperar dados do CDF, um administrador precisa registrar e consentir que sua organização use o Microsoft Power Query for Excel.

Para acessar os dados no modelo de dados, você precisa destas competências em um projeto por nível de espaço: dataModelsAcl:read, dataModelInstancesAcl:read. Veja

Veja Configurar acesso aos modelos de dados.

Para acessar os metadados dos elementos principais do CDF, como as séries temporais ou arquivos, você precisa ter acesso ao elemento a nível de projeto ou conjunto de dados. Ver Atribuir competências.

Conecte o Power BI connector ao modelo de dados

1. Antes de iniciar: Para conectar-se a um modelo de dados com o Cognite Power BI connector, você precisa saber o nome e a versão do modelo de dados e do projeto CDF onde ele está sendo usado. Para encontrar as informações:

   1. Vá até fusion.cognite.com, faça login no projeto CDF e acesse Gerenciamento de dados > Explorar > Modelos de dados.

   2. Selecione o modelo de dados e Conexões > Power BI.

   3. Na caixa de diálogo, copie e faça uma observação sobre o nome do projeto e o ambiente do CDF.

      

2. Abra o Power BI Desktop e faça login na conta da sua organização.

3. Na guia Página inicial da faixa de opções, selecione Obter dados e depois Mais. Em seguida, na caixa de diálogo Obter dados, selecione Outros e depois o conector do Cognite Data Fusion.

   

4. Insira os dados que você anotou sobre o modelo de dados e o projeto CDF em Nome do projeto e no CDF: Campos de ambiente.

   Opcional: Para fazer login com uma ID de locatário específica do Microsoft Entra ID (antes conhecido como Azure Active Directory), anexe o parâmetro tenantid={tenantId} à URI do nome do projeto neste formato:

   {projectName}/models/spaces/{space}/datamodels/{datamodel}/versions/{version}?tenantid={tenantId}

   • Onde {tenantId} é o GUID do locatário do Microsoft Entra ID que você deseja usar, por exemplo, d1ce9074-3079-488a-9a2d-f0522babd7a9.

   Para encontrar a ID de locatário do Microsoft Entra ID, entre em contato com o administrador ou siga as etapas neste artigo.

5. Na caixa de diálogo Autenticação, selecione Conta organizacional e depois Fazer login com sua ID organizacional.

   

6. O conector Power BI lista todos os tipos de modelos de dados selecionados.

   Cada Type nos modelos de dados é exibido como uma tabela no Power BI, com cada Instance do tipo em linha.

7. Selecione uma tabela (tipo) e depois Transformar dados.

   cuidado

   A tabela pode conter um grande número de entradas. Não selecione Carregar, a menos que queira carregar todas as entradas.

   

8. Você agora pode transformar os dados com o Power Query Editor.

   Para limitar o conjunto de dados, você pode, por exemplo, selecionar Manter Linhas > Manter Primeiras Linhas e especificar o número de linhas que deseja manter.

   

   Para carregar os valores resultantes no Power BI, selecione Fechar e Aplicar.

informações

Power BI permite que você expanda o item relacionado para achatar a tabela. Isso pode ter um pacto negativo significante no desempenho. Por isso, recomendamos que você não use essa funcionalidade.

cuidado

A presença de caracteres especiais ! * ' ( ) ; : @ & = + $ , no space ou externalId pode impedir o Power BI de ler os dados do CDF com sucesso. Os caractere alfanuméricos e caracteres especiais - _ . ~ não causam problemas.

Filtrar itens nos modelos de dados

A filtragem é essencial para criar conjuntos de dados viáveis no Power BI. Recomendamos que você aplique a filtragem no Power Query em vez de no histórico/painel do Power BI. Isso melhora o desempenho e facilita o trabalho com conjuntos de dados reutilizáveis.

O Power BI Connector envia a filtragem para o CDF usando o serviço do Cognite OData. Por sua vez, o CDF executa a filtragem e retorna apenas as linhas correspondentes para o Power BI. Confira também Filtrar dados do CDF no Power BI.

Filtros com função de pushdown de modelagem de dados

Tipo	Pushdown
Propriedade do modelo	Sim, exceto EndsWith e Contains
Metadados de séries temporais	Não
Pontos de dados e de string	somente timestamp
Metadados de arquivos	Não

O Power Query performa as operações de filtragem de strings EndsWith e Contains na memória.

JSONObjects são apresentados como valores de texto no Power BI.

Trabalhe com séries temporais e pontos de dados

A modelagem de dados é compatível com as Timeseries dos modelos de dados. Para obter pontos de dados para séries temporais específicas, você pode ir até a string- ou os dataPoints. Para obter pontos de dados de um intervalo de tempo, basta filtrá-los em um valor de carimbo de data/hora. O CDF não é compatível com a filtragem de séries temporais em seus valores.

As séries temporais podem contar dados altamente granulados. Para melhorar o desempenho e reduzir o carregamento de dados, use a função dataPoint Aggregate do CDF, que é semelhante à função Obter agregações para uma única série temporal.

O Power BI converte automaticamente um valor de carimbo de data/hora do Unix Epoch em um valor de UTC DateTime.

Para criar uma exibição que mostre os dois últimos dias dos dados de uma série temporal, recomendamos que você use a função aggregate para Time Series. Com Power Query, você pode especificar valores dinâmicos que se modificam a cada vez que o conjunto de dados é atualizado. Por exemplo, a função DateTimeZone.UtcNow() Power Query sempre retorna a data e hora no horário UTC. Ao combinar isto com funções Date.AddX, como Date.AddDays, você pode criar um intervalo dinâmico para a consulta ser movida para o CDF como uma chamada de função agregada. Isso resulta em uma atualização de dados mais rápida.

Quando for usar utilizar os dados como um filtro de parâmetros de função, use o tipo PowerQuery DateTimeZone

Saiba mais:

• Obter agregações de uma única série temporal
• Power Query Funções de dados
• Power Query Funções de DateTimeZone

Modifique o usuário logado

Depois que você faz o login, o Power BI armazena suas credenciais de origem de dados. Se você deseja acessar o modelo de dados com um usuário diferente, delete as credenciais salvas na origem de dados:

1. No Power BI Desktop, vá até Arquivo > Opções e configurações > Configurações de origem de dados.
2. Edite ou exclua as credenciais de login salvas na origem de dados.