Ga verder naar hoofdinhoud

Power BI connector (REST API)

Gebruik de Power BI REST API-connector om gegevens op te halen met de Cognite OData-services of andere Cognite API's via GET of POST en met GraphQL-query's voor Cognite-gegevensmodellen.

Bèta

De functies die in dit gedeelte worden beschreven, worden momenteel in de bètafase getest door geselecteerde klanten en kunnen nog worden gewijzigd.

Stel een verbinding met Cognite Data Fusion in (CDF)​

Volg deze stappen om een Cognite Data Fusion (CDF)-project te verbinden als gegevensbron in Power BI:

  1. U kunt uw organisatieaccount gebruiken om u aan te melden bij Power BI Desktop.

  2. Ga naar het tabblad Start en selecteer Gegevens ophalen en vervolgens Meer. Zoek in het dialoogvenster Gegevens ophalen naar Cognite en selecteer de Cognite Data Fusion (REST API)-connector.

    Zoek de CDF REST API-connector in Power BI

  3. Voer in het dialoogvenster de details in om de verbinding met CDF te configureren:

    • CDF-project: Voer de naam in van het CDF-project waarmee u verbinding wilt maken.

    • CDF-organisatie: Voer de organisatie in waarmee u zich wilt aanmelden bij CDF.

    De CDF REST API-connector configureren in Power BI

  4. Meld u aan met uw accountreferenties wanneer u daarom wordt gevraagd.

  5. Selecteer Connect om het Navigator-venster te openen.

  6. Selecteer de functie(s) die u wilt gebruiken en selecteer vervolgens Gegevens transformeren om de Power Query Editor te openen en gegevens op te halen uit CDF.

    Functies selecteren met de REST API-connector in Power BI

Gebruik de maximaal ondersteunde paginagrootte als u aanvragen maakt die paginering ondersteunen (via limit-parameters in GET/POST-aanvragen of de first-parameter in GraphQL-query's). Kleinere pagina's zorgen voor meer API-aanroepen en kunnen een aanzienlijke impact hebben op de laadtijd. Raadpleeg de Cognite API-documentatie voor de maximaal ondersteunde paginagrootte voor elk eindpunt. Voor GraphQL-query's geldt een maximumlimiet van 1000 exemplaren per pagina.

Gegevens filteren​

Wanneer u de REST API-functies gebruikt, kunt u filters op de server toepassen zodat er in eerste instantie minder gegevens worden geladen in Power BI.

Als u OData gebruikt, kan Power BI sommige filters pushen naar de OData-service wanneer u de Power Query-editor gebruikt.

Voor GraphQL-query's kunt u filters rechtstreeks in de query toepassen om de hoeveelheid gegevens te beperken die in Power BI worden geladen. U kunt ook GraphQL-queryvariabelen gebruiken om uw query's te parametriseren zodat ze makkelijker opnieuw kunnen worden gebruikt.

Geplande vernieuwing​

Nadat u uw rapport hebt gepubliceerd naar de Power BI-service, kunt u gegevensvernieuwingen plannen om uw gegevens actueel te houden.

Foutverwerking​

Wanneer u aangepaste GET en POST-aanvragen schrijft, kunnen er fouten optreden als u een ongeldige URL of hoofdtekst opgeeft. Als u een CogniteAPIError-foutmelding krijgt, raadpleegt u de referentiedocumentatie van de Cognite API en past u uw aanvraag aan.

Laatst bijgewerkt