Hopp til hovedinnhold

Power BI connector (REST API)

Bruk REST API-koblingen i Power BI til å hente data med Cognites OData-tjenester eller andre Cognite-API-er ved hjelp av GET, POST og med GraphQL-spørringer for Cognite-datamodeller.

Beta

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

Konfigurere en tilkobling til Cognite Data Fusion (CDF)​

Følg denne fremgangsmåten for å koble til et Cognite Data Fusion (CDF)-prosjekt som datakilde i Power BI:

  1. I Power BI Desktop logger du på med bedriftskontoen.

  2. På Home-fanen velger du Get data og deretter More. I dialogboksen Get Data søker du etter Cognite og velger koblingen Cognite Data Fusion (REST API).

    Finne REST-API-koblingen for CDF i Power BI

  3. I dialogboksen angir du informasjon for å konfigurere tilkoblingen til CDF:

    • CDF project: Angi navnet på CDF-prosjektet du kobler til.

    • CDF organization: Angi bedriften som skal brukes til å logge på CDF.

    Konfigurere REST-API-koblingen for CDF i Power BI

  4. Når du blir bedt om det, logger du inn med påloggingsinformasjonen for kontoen din.

  5. Velg Connect for å åpne Navigator-vinduet.

  6. Velg funksjonen(e) du vil bruke, og deretter velger du Transform Data for å åpne Power Query Editor og hente data fra CDF.

    Velge funksjoner ved hjelp av REST-API-koblingen i Power BI

Bruk den maks. støttede sidestørrelsen hvis du lager forespørsler som støtter paginering (via limit-parametere i GET/POST-forespørsler, eller via first-parameteren i GraphQL-spørringer). Mindre sidestørrelser øker API-oppkallinger og kan ha betydelig innvirkning på innlastingstid. Se Cognite-API-dokumentasjonen for maks. støttet sidestørrelse for hvert endepunkt. For GraphQL-spørringer er maks.grensen 1000 forekomster per side.

Filtrere data​

Når du bruker REST-API-funksjonen, kan du ta i bruk filtre på serversiden for å redusere dataene som først lastes inn i Power BI.

Hvis du bruker OData, kan Power BI skyve ned noen filtre til OData-tjenesten ved bruk av Power Query-redigeringsprogrammet.

For GraphQL-spørringer kan du ta i bruk filtre direkte i spørringen for å redusere mengden data som lastes inn i Power BI. Du kan også bruke GraphQL-spørringsvariabler til å parametrisere spørringene og gjøre dem mer gjenbrukbare.

Planlagt oppdatering​

Etter at du har publisert rapporten til Power BI-tjenesten, kan du planlegge intervaller for dataoppdateringer for å holde dataene oppdatert.

Feilhåndtering​

Når du skriver egendefinerte GET- og POST-forespørsler, kan du få feil hvis du oppgir en ugyldig nettadresse eller hoveddel. Hvis du mottar en CogniteAPIError-feilmelding, kan du se referansedokumentasjonen for Cognite-API og justere forespørselen.

Sist oppdatert