Hoppa till huvudinnehållet

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.

Beta

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:

  1. Logga in på ditt organisationskonto, i Power BI Desktop.

  2. 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).

    Leta upp CDF REST API-kontakten i Power BI
  3. 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.

    Konfigurera CDF REST API-kontakten i Power BI
  4. När du uppmanas till det loggar du in med dina inloggningsuppgifter för kontot.

  5. Välj Connect för att öppna fönstret Navigator.

  6. Välj den eller de funktioner du vill använda och välj sedan Transformera data för att öppna Power Query Editor och hämta data från CDF.

    Välja funktioner med REST API-kontakten i Power BI

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.