Funktionen der Power BI REST API

In diesem Artikel werden die verfügbaren Funktion der Power BI REST API vorgestellt.

Beta

Die in diesem Abschnitt beschriebenen Funktionen befinden sich für ausgewählte Kunden im Beta-Status und können noch geändert werden.

GetCDF

Verwenden Sie diese Funktion, um mithilfe der HTTP-GET-Methode Daten aus den CDF-APIs abzurufen. Die Funktion führt eine automatische Paginierung von CDF durch, bis der Cursor für die Anfrage vollständig abgearbeitet ist. Siehe für optimale Leistung die Cognite API Spezifikation für Informationen über Endpunkte, die diese HTTP-Methode unterstützen, und die maximal unterstützte Seitenanzahl für die einzelnen Endpunkte.

Parameter	Typ	Beschreibung
url	Text	Der URL-Pfad für die Anfrage, direkt auf den Projektnamen folgend. Beispiele: "/timeseries", "/assets".

PostCDF

Verwenden Sie diese Funktion, um mithilfe der HTTP-POST-Methode Daten aus den CDF-APIs abzurufen. Die Funktion führt eine automatische Paginierung von CDF durch, bis der Cursor für die Anfrage vollständig abgearbeitet ist. Siehe für optimale Leistung die Cognite API Spezifikation für Informationen über Endpunkte, die diese HTTP-Methode unterstützen.

Parameter	Typ	Beschreibung
url	Text	Der URL-Pfad für die Anfrage, direkt auf den Projektnamen folgend. Beispiele: "/timeseries/list", "/assets/list".
body	Text	Darstellung des JSON-Körpers, der bei der Anfrage gesendet wird. Beispiele: "{}", "{"limit": 1000}". Setzen Sie den Parameter limit, sofern verfügbar, auf den maximal unterstützten Wert für den Endpunkt. Siehe für optimale Leistung die Cognite API Spezifikation. Beim Aufruf dieser Funktion mit Power BI wird die Abfrage als mehrzeiliger Textbereich dargestellt. Doppelte Anführungszeichen müssen nicht maskiert werden. Wenn Sie einen ungültigen JSON-Körper verwenden, gibt die Funktion einen Fehler des Typs CogniteConnectorError zurück.

Hinweis

Die PostCDF-Funktion bietet für einfache Anfragen, die einen Cursor auf der obersten Ebene des Anforderungskörpers erwarten, eine automatische Paginierung. Bei komplexeren Anfragen müssen Sie mithilfe der M-Sprache von Power Query eine angepasste Paginierungslogik schreiben. Siehe den Artikel Funktionen und Beispielabfragen von Power Query.

GraphQL

Verwenden Sie diese Funktion, um mithilfe von GraphQL Daten aus einem CDF-Datenmodell abzurufen.

Parameter	Typ	Beschreibung
space	Text	Die externe ID des Datenmodell-Space.
datamodel	Text	Die externe ID des Datenmodells.
version	Text	Die Version des Datenmodells.
query	Text	Textdarstellung der GraphQL-Abfrage, die bei der Anfrage gesendet wird. Schließen Sie after:$cursor and pageInfo { hasNextPage endCursor } in die Abfrage ein, um die automatische Paginierung zu ermöglichen. Für optimale Leistung sollte der first-Parameter auf 1000 (maximal unterstützter Grenzwert) gesetzt werden. Beispiel: "query MyQuery($cursor: String) { listMovies(first: 1000, after: $cursor) { items { name } pageInfo { endCursor hasNextPage }}}". Beim Aufruf dieser Funktion mit Power BI wird die Abfrage als mehrzeiliger Textbereich dargestellt. Doppelte Anführungszeichen müssen nicht maskiert werden. Wenn Sie eine ungültige GraphQL-Abfrage verwenden, gibt die Funktion einen Fehler des Typs CogniteAPIError zurück.
variables	Text	Textdarstellung der JSON-Variablen, die bei der Anfrage gesendet werden. Beispiel: "{""country"": ""Norway""}". Die Variable cursor darf nicht in den Parameter variables eingebunden werden. Das Management erfolgt automatisch durch den Connector. Wenn Sie einen ungültigen JSON-Körper verwenden, gibt die Funktion einen Fehler des Typs CogniteConnectorError zurück.

Hinweis

Die GraphQL-Funktion bietet eine automatische Paginierung für GraphQL-Abfragen, die nur einen Abfrageausdruck mit einem Paginierungsziel enthalten, das durch die Felder after: $cursor und pageInfo { hasNextPage endCursor } gekennzeichnet ist. Bei komplexeren Abfragen müssen Sie mithilfe der M-Sprache von Power Query eine angepasste Paginierungslogik schreiben. Siehe auch den Artikel Funktionen und Beispielabfragen von Power Query. Vor der Verwendung von Abfragen und Variablen in Power BI sollten Sie diese immer mit dem CDF Query Explorer auf ihre Korrektheit hin testen.

ODataCDF

Verwenden Sie diese Funktion, um Daten aus den Cognite OData-Services abzurufen.

Parameter	Typ	Beschreibung
url	Text	Der URL-Pfad für die OData-Anfrage, einschließlich des Projektnamens. Beispiele: "publicdata", "publicdata/Timeseries".
apiVersion	Text (optional)	Die API-Version des OData-Service zur Verwendung bei der Anfrage. Standardvorgabe: "v1". Die neueste Version des anlagenbezogenen OData-Service ist "v1". Die neueste Version des OData-Service für die Datenmodellierung ist "20230821".

ODataDataModel

Verwenden Sie diese Funktion, um mithilfe von CDF Daten aus einem OData-Datenmodell abzurufen.

Parameter	Typ	Beschreibung
space	Text	Die externe ID des Datenmodell-Space.
datamodel	Text	Die externe ID des Datenmodells.
version	Text	Die Version des Datenmodells.
apiVersion	Text (optional)	Die API-Version des OData-Service zur Verwendung bei der Anfrage. Standardvorgabe: "20230821". Die neueste Version des OData-Service für die Datenmodellierung ist "20230821".