Hoppa till huvudinnehållet

OData Service för datamodellering

Anslut Cognite Data Fusion (CDF)-datamodell) som datakälla och använd OData-klienter för att fråga, transformera och visualisera data lagrade i CDF-datamodeller.

Med OData-tjänsten för datamodellering kan du komma åt datamodeller som har skapats i CDF med hjälp av OData-protokoll.

OData-tjänsten för datamodellering accepterar URL:er med följande schema:

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

Där:

  • {cluster}: namnet på CDF-kluster, t.ex. westeurope-1.
  • {apiVersion}: versionen av OData-tjänste-API:n (senaste är 20230821).
  • {project}: namnet på CDF-projektet t.ex. publicdata.
  • {spaceExternalId}: det externa ID:t för space där datamodellen publiceras.
  • {dataModelExternalId}: datamodellens externa ID.
  • {dataModelVersion}: datamodellens version.

Om du låter OData-klienten peka på den rätta OData-URL:n för datamodellen och autentiserar, returnerar servern en tabell med alla views som finns i den associerade datamodellen.

Anvisningar för tecken​

Följ dessa anvisningar för användning av tecken för fälten space och externalId i Power BI:

  • Säkert att använda:

    • Alfanumeriska tecken: a-z A-Z 0-9
    • Oreserverade specialtecken: - _ . ~

  • Använd med försiktighet:

    • Följande reserverade tecken kan fungera men det finns ingen garanti att de fungerar konsekvent: ! * ' ( ) ; : @ & = + $ ,

  • Undvik:

    • Alla specialtecken som inte visas i listan ovan kan förhindra att Power BI laddar eller navigerar i data korrekt.

Filtrera objekt i datamodeller​

Använd filter för att skapa datamängder som kan användas i rapporteringar eller på kontrollpaneler. OData-tjänsten för datamodellering stöder filtrering på serversidan vilket gör att du kan föra ner filter till servern för att undvika att behöva ladda ned alla data till klienten.

TypPushdown
ModellegenskapJa, förutom EndsWith och Contains
Metadata för tidsserierIngen
Data och strängpunktertimestamp endast
Metadata för filerIngen

Power Query utför EndsWith och Contains filtrering av strängar i minnet.

JSONObjects visas som textvärden i Power BI.

Arbeta med tidsserier och datapunkter​

OData-tjänsten för datamodellering hämtar Timeseries från datamodeller.

För att hämta datapunkter för en specifik tidsserie kan du gå till string eller dataPoints. Om du vill hämta datapunkter från ett tidsintervall filtrerar du datapunkten i en tidsstämpelvärde.

CDF stöder inte filtrering av tidsserier baserat på deras värden.

Tidsserier kan innehålla mycket detaljerade data. För att förbättra prestanda och minska mängden data som laddas kan du använda Aggregate-funktionen för dataPoint.

Kända begränsningar och problem​

Avsnittet nedan täcker kända begränsningar och problem relaterade till användningen av CDF-datamodeller som datakälla för Power BI.

Typer med relationer till andra typer​

Integreringen mellan CDF-datamodeller och Power BI har begränsad support för traversering av direkta relationer mellan noder som använder OData "expand"-konceptet.

Power BI bearbetar en åtgärd för att göra en tabell platt med hjälp av en expand-relation genom att skapa en separat API-förfrågan för varje instans/rad som ska expanderas. Detta är väldigt tidskrävande för alla större datavolymer.

Grafkanter och tillhörande egenskaper​

För närvarande stöder vi inte att egenskaper om kanter hämtas.

Datauppdateringar​

Det minsta uppdateringsintervallet för data i Power BI är 15 minuter. Du kan inte ladda data i små steg för kontrollpanelsuppdateringar med OData-tjänsten. Om en kontrollpanel innehåller en stor mängd data som kräver frekventa uppdateringar, kan det finnas bättre alternativ än att använda OData-tjänsten för datamodellering.

Senast uppdaterad