Power BI connector (REST API)
Verwenden Sie den Power BI REST API Connector, um Daten mit den Cognite OData-Services oder unter Verwendung von GET und POST mit anderen Cognite-APIs sowie mit GraphQL-Abfragen für Cognite-Datenmodelle abzurufen.
Die in diesem Abschnitt beschriebenen Funktionen befinden sich für ausgewählte Kunden im Beta-Status und können noch geändert werden.
Eine Verbindung mit Cognite Data Fusion (CDF) einrichten
Gehen Sie wie folgt vor, um ein Cognite Data Fusion (CDF)-Projekt als Datenquelle in Power BI zu verbinden:
-
Melden Sie sich mit Ihrem Unternehmenskonto am
Power BI Desktopan. -
Wählen Sie auf der Registerkarte Home Get Data und dann More aus. Suchen Sie im Dialogfeld Get Data nach Cognite und wählen Sie den Cognite Data Fusion (REST API) Connector aus.
-
Geben Sie in das Dialogfeld die Informationen für die Konfiguration der Verbindung mit
CDFein:-
CDF project: Geben Sie den Namen des
CDF-Projekts ein, mit dem Sie sich verbinden möchten. -
CDF organization: Geben Sie die Organisation ein, um sich bei
CDFanzumelden.
-
-
Melden Sie sich auf Aufforderungen mit den Anmeldeinformationen Ihres Kontos an.
-
Wählen Sie Connect aus, um das Fenster Navigator zu öffnen.
-
Wählen Sie die Funktion(en) aus, die Sie verwenden möchten, und wählen Sie anschließend Transform Data aus, um den
Power Query Editorzu öffnen und Daten ausCDFabzurufen.
Verwenden Sie die maximal unterstützte Seitengröße, wenn Sie Anfragen stellen, die eine Paginierung unterstützen (über limit-Parameter bei GET/POST-Anfragen oder über den first-Parameter bei GraphQL-Abfragen). Durch eine geringere Seitengröße erhöhen sich die API-Aufrufe, was sich deutlich auf die Ladezeit auswirken kann. Siehe die Cognite API Spezifikation für Informationen über die maximal unterstützte Seitenanzahl für die einzelnen Endpunkte. Im Fall von GraphQL-Abfragen beträgt der maximale Grenzwert 1000 Instanzen pro Seite.
Daten filtern
Bei der Verwendung von REST-API-Funktionen können Sie serverseitige Filter anwenden, um die in Power BI zu ladende Datenmenge zu reduzieren.
Wenn Sie OData nutzen, kann Power BI einige Filter an den OData-Service weiterleiten, sofern der Power Query Editor verwendet wird.
Im Fall von GraphQL-Abfragen können Sie Filter direkt in der Abfrage anwenden, um die in Power BI zu ladende Datenmenge zu reduzieren. Sie können darüber hinaus auch GraphQL-Abfragevariablen verwenden, um Ihre Abfragen zu parametrisieren und ihre Wiederverwendung zu ermöglichen.
Geplante Aktualisierung
Nach der Veröffentlichung Ihres Berichts im Power BI-Service können Sie Datenaktualisierungen zeitlich planen, um Ihre Daten auf dem neuesten Stand zu halten.
Fehlerbehebung
Wenn Sie angepasste GET- und POST-Anfragen schreiben, erhalten Sie möglicherweise eine Fehlermeldung, wenn Sie eine ungültige URL oder einen ungültigen Anfragekörper verwenden. Wenn Sie eine CogniteAPIError-Fehlermeldung erhalten, schlagen Sie in der Cognite API-Referenzdokumentation nach, um Ihre Anfrage entsprechend zu korrigieren.