Power BI REST API-funksjoner

Denne artikkelen gir detaljer om de tilgjengelige Power BI-REST-API-funksjonene.

Beta

Funksjonene som er beskrevet i dette avsnittet, er for øyeblikket i betatesting hos utvalgte kunder og kan bli endret.

GetCDF

Bruk denne funksjonen til å hente data fra CDF-API-er ved hjelp av HTTP GET-metoden. Funksjonen paginerer CDF automatisk til forespørselsmarkøren er utslitt. Du kan sikre optimal ytelse ved å se Cognite API-spesifikasjonen for endepunkter som støtter denne HTTP-metoden, og maks. støttet sidestørrelse for hvert endepunkt.

Parameter	Type	Beskrivelse
url	Tekst	Nettadressebanen fore å sende forespørselen, starter rett etter prosjektnavnet. Eksempler: "/timeseries", "/assets"

PostCDF

Bruk denne funksjonen til å hente data fra CDF-API-er ved hjelp av HTTP POST-metoden. Funksjonen paginerer CDF automatisk til forespørselsmarkøren er utslitt. Du kan sikre optimal ytelse ved å se Cognite API-spesifikasjonen for endepunkter som støtter denne HTTP-metoden.

Parameter	Type	Beskrivelse
url	Tekst	Nettadressebanen fore å sende forespørselen, starter rett etter prosjektnavnet. Eksempler: "/timeseries/list", "/assets/list"
body	Tekst	En tekstrepresentasjon av JSON-hoveddelen som skal sendes sammen med forespørselen. Eksempler: "{}", "{"limit": 1000}" Når det er mulig, bør du sette parameteren limit til maks. støttet verdi for endepunktet. Se Cognite API-spesifikasjonen for optimal ytelse. Når du kaller opp denne funksjonen med Power BI, presenteres spørringen som et tekstområde med flere linjer. Du trenger ikke å bruke anførselstegn på hver side av doble anførselstegn. Hvis du oppgir en ugyldig JSON-hoveddel, returnerer funksjonen en feil av typen CogniteConnectorError.

merk

PostCDF-funksjonen tilbyr automatisk paginering for enkle forespørsler som forventer en markør på det øverste nivået i forespørselshoveddelen. For mer komplekse forespørsler må du skrive en egendefinert pagineringslogikk medPower Query-M-språket. Se artikkelen om Power Query-funksjoner og eksempelspørringer.

GraphQL

Bruk denne funksjonen til å hente data fra en CDF-datamodell ved hjelp av GraphQL.

Parameter	Type	Beskrivelse
space	Tekst	Den eksterne ID-en til datamodellområdet.
datamodel	Tekst	Den eksterne ID-en til datamodellen.
version	Tekst	Versjonen til datamodellen.
query	Tekst	En tekstrepresentasjon av GraphQL-spørringen som skal sendes når du lager forespørselen. Inkluder after:$cursor and pageInfo { hasNextPage endCursor } i spørringen for å aktivere automatisk paginering. Vurder å sette parameteren first til 1000 (maks. støttet grense) for optimal ytelse. Eksempel: "query MyQuery($cursor: String) { listMovies(first: 1000, after: $cursor) { items { name } pageInfo { endCursor hasNextPage }}}". Når du kaller opp denne funksjonen med Power BI, presenteres spørringen som et tekstområde med flere linjer. Du trenger ikke å bruke anførselstegn på hver side av doble anførselstegn. Hvis du oppgir en ugyldig GraphQL-spørring, returnerer funksjonen en feil av typen CogniteAPIError.
variables	Tekst	En tekstrepresentasjon av JSON-variabler som skal sendes når du lager forespørselen. Eksempel: "{""country"": ""Norway""}". Ikke inkluder cursor-variabelen i parameteren variables. Den styres automatisk av koblingen. Hvis du oppgir en ugyldig JSON-hoveddel, returnerer funksjonen en feil av typen CogniteConnectorError.

merk

GraphQL-funksjonen tilbyr automatisk paginering for GraphQL-spørringer som bare inkluderer ett spørringsuttrykk med ett pagineringsmål, identifisert ved hjelp av feltene after: $cursor og pageInfo { hasNextPage endCursor }. For mer komplekse spørringer må du skrive en egendefinert pagineringslogikk medPower Query-M-språket. Se også artikkelen Power Query-funksjoner og eksempelspørringer. Før du bruker spørringene og variablene i Power BI, må du alltid teste dem med CDF Query Explorer for å sikre at de er riktige.

ODataCDF

Bruk denne funksjonen til å hente data fra Cognite OData-tjenestene.

Parameter	Type	Beskrivelse
url	Tekst	Nettadressebanen til OData-forespørselen, inkludert prosjektnavnet. Eksempler: "publicdata", "publicdata/Timeseries"
apiVersion	Tekst (valgfritt)	API-versjonen til OData-tjenesten som skal brukes til forespørselen. Standard: "v1" Den nyeste versjonen av den asset-centric OData-tjenesten er "v1". For OData-tjenesten for datamodellering er nyeste versjon "20230821".

ODataDataModel

Hent data fra en datamodell i CDF ved hjelp av OData-tjenesten for datamodellering.

Parameter	Type	Beskrivelse
space	Tekst	Den eksterne ID-en til datamodellområdet.
datamodel	Tekst	Den eksterne ID-en til datamodellen.
version	Tekst	Versjonen til datamodellen.
apiVersion	Tekst (valgfritt)	API-versjonen til OData-tjenesten som skal brukes til forespørselen. Standard: "20230821" Den nyeste versjonen av OData-tjenesten for datamodellering er "20230821".