Passer au contenu principal

Service OData de modélisation des données

Connectez un modèle de données Cognite Data Fusion (CDF) comme source de données et utilisez des clients OData pour interroger, transformer et visualiser les données stockées dans des modèles de données CDF.

Le service OData de modélisation des données permet d’accéder aux modèles de données créés dans CDF via les protocoles OData.

Le service OData de modélisation des données accepte les URL présentant le schéma suivant :

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

Où :

  • {cluster} : le nom du cluster CDF, par exemple, westeurope-1.
  • {apiVersion} : la version de l’API du service OData (la version la plus récente est 20230821).
  • {project} : le nom du projet CDF, par exemple, publicdata.
  • {spaceExternalId} : l’ID externe pour space où le modèle de données est publié.
  • {dataModelExternalId} : l’ID externe du modèle de données.
  • {dataModelVersion} : la version du modèle de données.

Si vous dirigez le client OData vers l’URL appropriée du service OData de modélisation des données et vous authentifiez correctement, le serveur renvoie un tableau contenant toutes les views existantes dans le modèle de données associé.

Consignes relatives à l’utilisation des caractères​

Respectez les consignes suivantes en matière d’utilisation des caractères pour compléter les champs space et externalId dans Power BI :

  • Caractères sûrs :

    • Caractères alphanumériques : a-z A-Z 0-9
    • Caractères spéciaux non réservés : - _ . ~

  • Caractères à utiliser avec prudence :

    • La fiabilité des caractères réservés suivants n’est pas garantie : ! * ' ( ) ; : @ & = + $ ,

  • Caractères à éviter :

    • Tout caractère spécial non répertorié ci-avant peut empêcher Power BI de charger ou d’explorer correctement les données.

Filtrage des éléments dans les modèles de données​

Utilisez le filtrage pour créer des jeux de données exploitables dans des rapports ou des tableaux de bord. Le service OData de modélisation des données prend en charge le filtrage côté serveur. Cela vous permet d’envoyer des filtres (via une transmission de type Pushdown) à destination du serveur afin d’éviter de télécharger l’intégralité des données dans le client.

TypePushdown
Propriété du modèleOui, sauf EndsWith et Contains
Métadonnées des séries temporellesNon
Points de données et de chaînetimestamp seulement
Métadonnées des fichiersNon

Power Query exécute les opérations de filtrage de chaîne EndsWith et Contains en mémoire.

Les JSONObjects sont présentés sous forme de valeurs de texte dans Power BI.

Utilisation des séries temporelles et des points de données​

Le service OData de modélisation des données permet de récupérer des Timeseries à partir de modèles de données.

Pour obtenir des points de données pour une série temporelle spécifique, vous pouvez accéder à string ou dataPoints. Pour obtenir des points de données à partir d’une plage de temps, filtrez le point de données en fonction d’une valeur d’horodatage.

CDF ne permet pas de filtrer les séries temporelles en fonction de leurs valeurs.

Les séries temporelles peuvent contenir des données hautement granulaires. Pour améliorer les performances et limiter la quantité de données chargées, utilisez la fonction Aggregate pour les points de données.

Limitations et problèmes connus​

Les sections ci-après traitent des limitations et problèmes connus liés à l’utilisation des modèles de données CDF comme source de données pour Power BI.

Types avec des relations à d’autres types​

L’intégration entre les modèles de données CDF et Power BI offre une prise en charge limitée pour croiser les relations directes entre les nœuds en appliquant le concept « expand » (développement) d’OData.

Power BI traite une opération pour aplatir un tableau à l’aide d’une relation « expand » en effectuant une demande d’API indépendante pour chaque instance/ligne à développer. Cela peut prendre un temps considérable notamment si le volume de données est conséquent.

Bords des graphiques et propriétés associées​

La récupération des propriétés associées aux bords des graphiques n’est actuellement pas prise en charge.

Actualisation des données​

La fréquence d’actualisation minimum des données dans Power BI est de 15 minutes. Le service OData ne permet pas de charger des données par petits incréments lors des mises à jour des tableaux de bord. Si un tableau de bord contient une grande quantité de données nécessitant des mises à jour fréquentes, le service OData de modélisation des données n’est peut-être pas la meilleure option.

Dernière mise à jour