Hopp til hovedinnhold

OData-tjeneste for datamodellering

Koble til en Cognite Data Fusion-datamodell (CDF)-datamodell som datakilde, og bruk OData-klienter til å utføre spørringer på, endre og visualisere data lagret i CDF-datamodeller.

OData-tjenesten for datamodellering gjør at du kan bruke datamodeller opprettet i CDF ved hjelp av OData-protokoller.

OData-tjenesten for datamodellering godtar nettadresser med følgende skjema:

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

Der:

  • {cluster}: navnet på CDF-klyngen, f.eks. westeurope-1.
  • {apiVersion}: versjon av OData-tjeneste-API-et (nyeste er 20230821).
  • {project}: navnet på CDF-prosjektet, f.eks. publicdata.
  • {spaceExternalId}: den eksterne ID-en til space der datamodellen er publisert.
  • {dataModelExternalId}: den eksterne ID-en til datamodellen.
  • {dataModelVersion}: versjonen til datamodellen.

Hvis du peker OData-klienten til riktig OData-nettadresse for datamodeller og autentiserer deg, returnerer serveren en tabell med alle views som finnes om den tilknyttede datamodellen.

Retningslinjer for tegn​

Følg disse retningslinjene for bruk av tegn for feltene space og externalId i Power BI:

  • Trygge å bruke:

    • Alfanumeriske tegn: a-z A-Z 0-9
    • Tillatte spesialtegn: - _ . ~

  • Bruk med forsiktighet:

    • Følgende tillatte tegn kan fungere, men er ikke garantert at de alltid fungerer: ! * ' ( ) ; : @ & = + $ ,

  • Unngå:

    • Alle spesialtegn som ikke står oppført over, kan forhindre Power BI fra å bli lastet inn eller forhindre riktig navigering i data.

Filtrere elementer i datamodeller​

Bruk filtre til å opprette fungerende datasett for rapportering eller bruk av instrumentbord. OData-tjenesten for datamodellering støtter filtrering på serversiden som gjør at du kan skyve ned filtre til serveren for å unngå å laste ned alle dataene til klienten.

TypePushdown
ModellegenskapJa, bortsett fra EndsWith og Contains
Metadata for tidsserierNei
Data- og strengpunkterBare timestamp
Metadata for filerNei

Power Query utfører strengfiltreringsoperasjoner med EndsWith og Contains i minnet.

JSONObjects presenteres som tekstverdier i Power BI.

Arbeide med tidsserier og datapunkter​

OData-tjenesten for datamodellering støtter henting av Timeseries fra datamodeller.

Hvis du vil hente datapunkter for en bestemt tidsserie, kan du gå til string eller dataPoints. Hvis du vil hente datapunkter fra et tidsintervall, filtrerer du datapunktet på en tidsstempelverdi.

CDF støtter ikke filtrering av tidsserier basert på verdien deres.

Tidsserier kan inneholde data med et høyt detaljnivå. Du kan forbedre ytelsen og redusere databelastningen ved å bruke Aggregate-funksjonen for datapunkter.

Kjente begrensninger og problemer​

Avsnittene nedenfor dekker gjeldende kjente begrensninger og problemer knyttet til bruk av CDF-datamodeller som datakilde for Power BI.

Typer med relasjoner til andre typer​

Integreringen mellom CDF-datamodeller og Power BI har begrenset støtte for å krysse direkte relasjoner mellom noder ved hjelp av OData-konseptet "utvid".

Power BI behandler en operasjon for å flate ut en tabell som bruker en utvid-relasjon, ved å utstede en egen API-forespørsel for hver forekomst/rad som skal utvides. Dette er svært tidkrevende for et betydelig datavolum.

Grafkanter og tilknyttede egenskaper​

Vi støtter for øyeblikket ikke henting av egenskaper i kanter.

Dataoppdateringer​

Minimumsfrekvensen for oppdatering for data i Power BI er 15 minutter. OData-tjenesten lar deg ikke laste inn data i små trinn for instrumentbordoppdateringer. Hvis et instrumentbord inneholder store mengder data som krever hyppige oppdateringer, kan det hende det finnes bedre alternativer enn å bruke OData-tjenesten for datamodellering.

Sist oppdatert