Saltar al contenido principal

Servicio OData de modelado de datos

Conecte un modelo de datos Cognite Data Fusion (CDF)) como una fuente de datos y use clientes OData para consultar, transformar y visualizar datos en los modelos de datos CDF.

El servicio OData de modelado de datos le permite acceder a los modelos de datos creados en CDF usando los protocolos OData.

El servicio de modelado de datos OData acepta URL con el siguiente esquema:

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

Donde:

  • {cluster}: es el nombre del clúster de CDF, por ejemplo, westeurope-1.
  • {apiVersion}: la versión de la API del servicio OData (la más reciente es 20230821).
  • {project}: el nombre del proyecto CDF, por ejemplo, publicdata.
  • {spaceExternalId}: la ID externa de space donde el modelo de datos está publicado.
  • {dataModelExternalId}: la ID externa del modelo de datos.
  • {dataModelVersion}: la versión del modelo de datos.

Si apunta el cliente OData a la URL de modelo de datos OData correcta y se autentica, el servidor devolverá una tabla con todos los views que existen en el modelo de datos asociado.

Pautas en cuanto a caracteres

Siga estas pautas de uso de caracteres cuando rellene los campos space y externalId en Power BI:

  • Uso seguro:

    • Caracteres alfanuméricos: a-z A-Z 0-9
    • Caracteres especiales no reservados: - _ . ~
  • Usar con precaución:

    • Los siguientes caracteres reservados pueden funcionar, pero no se garantiza que funcionen de manera consistente: ! * ' ( ) ; : @ & = + $ ,
  • Evitar:

    • Cualquier carácter especial que no se incluya en la lista anterior puede impedir que Power BI cargue los datos o navegue por ellos correctamente.

Filtrar elementos en modelos de datos

Use filtros para crear conjuntos de datos viables para informes o paneles. El servicio de modelado de datos OData admite el filtrado del lado del servidor, que le permite enviar filtros al servidor para evitar descargar todos los datos al cliente.

TipoDelegación
Mostrar las propiedadesSí, excepto EndsWith y Contains
Metadatos de series cronológicasNo
Puntos de filtrado de cadenas y datostimestamp solamente
Metadatos de archivosNo

Power Query realiza las operaciones de filtrado de la memoria con las cadenas EndsWith y Contains.

JSONObjects se presentan como valores de texto en Power BI.

Trabajar con series cronológicas y puntos de datos

El servicio de modelado de datos OData admite la obtención de Timeseries a partir de modelos de datos.

Para obtener puntos de datos de una serie cronológica específica, puede navegar por string o dataPoints. Para obtener puntos de datos de un intervalo de tiempo, filtre los puntos de datos según un valor de marca de tiempo.

CDF no admite el filtrado de series cronológicas según sus valores.

Las series cronológicas pueden contener datos muy granulares. Para mejorar el rendimiento y reducir la carga de datos, utilice la función dataPoint Aggregate.

Limitaciones y problemas conocidos

En las secciones siguientes, se abordan las limitaciones y los problemas conocidos actuales relacionados con el uso de los modelos de datos CDF como fuente de datos para Power BI.

Tipos con relaciones con otros tipos

La integración entre los modelos de datos de CDF y Power BI tiene compatibilidad limitada cuando se trata de atravesar relaciones directas entre nodos utilizando el concepto de "expand" de OData.

Power BI procesa una operación para aplanar una tabla utilizando una relación de expansión mediante la emisión de una solicitud de API independiente para cada instancia/fila que se expandirá. Esto consume mucho tiempo si el volumen de datos es considerable.

Aristas de gráficos y propiedades adjuntas

Actualmente, no admitimos la recuperación de propiedades en aristas.

Actualizaciones de datos

La frecuencia de actualización mínima de los datos en Power BI es de 15 minutos. El servicio OData no le permite cargar datos en pequeños incrementos para las actualizaciones del panel. Si un tablero contiene una gran cantidad de datos que requieren actualizaciones frecuentes, puede haber mejores opciones que usar el servicio de modelado de datos OData.