Power BI connector (REST API)
Använd Power BI REST API-kontakten för att hämta data med Cognites OData-tjänster eller andra Cognite API:er som använder GET
, POST
, och med GraphQL-frågor för Cognite-datamodeller.
De funktioner som beskrivs i det här avsnittet beta-testas för närvarande av utvalda kunder och kan komma att ändras.
Ställ in en anslutning till Cognite Data Fusion (CDF)
Följ dessa steg för att ansluta ett Cognite Data Fusion (CDF)-projekt som en datakälla i Power BI:
-
Logga in på ditt organisationskonto, i
Power BI Desktop. -
På fliken Hem väljer du Hämta data och sedan Mer. I dialogrutan Hämta data söker du efter Cognite och väljer kontakten Cognite Data Fusion (REST API).
-
I dialogrutan anger du detaljer för att konfigurera kontakten till
CDF:-
CDF-projekt: Ange namnet på det
CDF-projekt som du ansluter till. -
CDF-organisation: Ange organisationen att använda för att logga in i
CDF.
-
-
När du uppmanas till det loggar du in med dina inloggningsuppgifter för kontot.
-
Välj Connect för att öppna fönstret Navigator.
-
Välj den eller de funktioner du vill använda och välj sedan Transformera data för att öppna
Power Query Editoroch hämta data frånCDF.
Använd den maximalt tillåtna sidstorleken om du gör förfrågningar som stöder paginering (via limit
parametrar i GET/POST-förfrågningar eller first
-parametern i GraphQL-frågor). Mindre sidstorlekar ökar API-samtal och kan betydligt påverka laddningstider. Se Cognite API-dokumentationen för den maximala sidstorlek som stöds för varje slutpunkt. För GraphQL-frågor är maxgränsen 1000 instanser per sida.
Filtrera data
När du använder REST API-funktioner kan du tillämpa filter på serversidan för att reducera den initiala mängd data som laddas in till Power BI.
Om du använder OData, kan Power BI föra ner några filter till OData-tjänsten när Power Query-redigeraren används.
För GraphQL-frågor kan du tillämpa filter direkt i frågan för att minska mängden data som laddas in i Power BI. Du kan även använda GraphQL-frågevariabler för att parametrisera dina frågor och göra dem mer återanvändbara.
Schemalagd uppdatering
När rapporten har publicerats till Power BI-tjänsten, kan du schemalägga datauppdateringar för att hålla data aktuella.
Felhantering
När du skriver anpassade GET
- och POST
-förfrågningar kan det uppstå fel om du anger en ogiltig URL eller ogiltiga data. Om du får ett CogniteAPIError
-felmeddelande kan du se i Cognite API:s referensdokumentation och justera din förfrågan.