Serviço do OData de modelagem de dados

Conecte um modelo de dados do Cognite Data Fusion (CDF) como fonte de dados e utilize clientes do OData para consultar, transformar e visualizar dados armazenados em modelos de dados do CDF.

O serviço de modelagem de dados do OData permite acessar modelos de dados criados no CDF usando protocolos do OData.

O serviço de modelagem de dados do OData aceita URLs com o seguinte esquema:

https://{cluster}.cognitedata.com/odata/{apiVersion}/projects/{project}/models/spaces/{spaceExternalId}/datamodels/{dataModelExternalId}/versions/{dataModelVersion}

Onde:

• {cluster}: é o nome do cluster do CDF (por exemplo westeurope-1).
• {apiVersion}: é a versão da API do serviço do OData (a mais recente é 20230821).
• {project}: é o nome do projeto do CDF (por exemplo publicdata).
• {spaceExternalId}: a ID externa do space em que o modelo de dados do is publicado.
• {dataModelExternalId}: a ID externa do modelo de dados.
• {dataModelVersion}: a versão do modelo de dados.

Se você direcionar o cliente do OData para o URL correto do modelo de dados do OData e autenticar, o servidor retorna uma tabela com todos os views existentes no modelo de dados associado.

Orientações sobre caracteres

Siga estas orientações de uso de caracteres para os campos space e externalId no Power BI:

• Seguro para usar:

  • Caracteres alfanuméricos: a-z A-Z 0-9
  • Caracteres especiais irrestritos: - _ . ~

• Use com cautela:

  • Os seguintes caracteres reservados podem funcionar, mas não é garantido que tenham um desempenho consistente: ! * ' ( ) ; : @ & = + $ ,

• Evite:

  • Quaisquer caracteres especiais não listados acima podem impedir que o Power BI faça carregamento ou a navegação dos dados corretamente.

Filtrar itens nos modelos de dados

Utilize filtros para criar conjuntos de dados viáveis para relatórios ou painéis. O serviço de modelagem de dados do OData oferece suporte a filtragem no lado do servidor, o que permite enviar filtros para o servidor, evitando o download de todos os dados para o cliente.

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 executa 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

O serviço de modelagem de dados do OData oferece suporte para buscar Timeseries a partir de 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 filtragem de séries temporais com base em seus valores.

As séries temporais podem contar dados altamente granulados. Para melhorar o desempenho e reduzir a carga de dados, utilize a função Aggregate de dataPoint.

Limitações e problemas conhecidos

As seções abaixo abordam as limitações e problemas conhecidos atualmente relacionados ao uso de modelos de dados do CDF como fonte de dados para Power BI.

Tipos com relações com outros tipos

A integração entre modelos de dados do CDF e o Power BI tem suporte limitado para percorrer relações diretas entre nós usando o conceito de "expandir" OData].

O Power BI processa uma operação para achatar uma tabela usando uma relação de expansão, emitindo uma solicitação de API separada para cada instância/linha a ser expandida. Esse processo leva tempo para qualquer volume significativo de dados.

Bordas do gráfico e propriedades anexadas

Atualmente, não oferecemos suporte a recuperação de propriedades em bordas.

Atualizações de dados

A taxa mínima de atualização de dados em Power BI é de 15 minutos. O serviço do OData não permite carregar dados em pequenos incrementos para atualizações do painel. Se um painel contiver uma grande quantidade de dados que requerem atualizações frequentes, pode haver opções melhores do que usar o serviço de modelagem de dados do OData.