Query Execution - Execute Query

Dienst:

Dataflow

API-Version:

v1

Führt eine Abfrage für einen Datenfluss aus und gibt das Ergebnis zurück.
Führt eine angegebene Abfrage für einen Datenfluss aus und streamt die Ergebnisse im Apache Arrow-Format. Unterstützt die Verwendung von benutzerdefinierten Mashupdokumenten für erweiterte Szenarien.

Diese API unterstützt LRO-.

Erlaubnisse

Der Aufrufer muss über Ausführungsberechtigungen für den Datenfluss verfügen.

Erforderliche delegierte Bereiche

Dataflow.Execute.All oder Item.Execute.All.

Einschränkungen

Abfragen können maximal 90 Sekunden lang ausgeführt werden.

Von Microsoft Entra unterstützte Identitäten

Diese API unterstützt die in diesem Abschnitt aufgeführten Microsoft Identitäten.

Identität	Support
Benutzer	Yes
Service Principal und Verwaltete Identitäten	Yes

Schnittstelle

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/executeQuery

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dataflowId	path	True	string (uuid)	Die Datenfluss-ID.
workspaceId	path	True	string (uuid)	Die Arbeitsbereichs-ID.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
queryName	True	string	Der Name der Abfrage, die aus dem Datenfluss ausgeführt werden soll (oder aus dem benutzerdefinierten Mashupdokument, sofern angegeben).
customMashupDocument		string	Optionales benutzerdefiniertes Mashupdokument zum Überschreiben des Standardmäßigen Mashups des Datenflusses.

Antworten

Name	Typ	Beschreibung
200 OK	file	Das Abfrageergebnis wurde erfolgreich geschrieben. Ergebnisse werden im Apache Arrow-Format gestreamt. In der Arrow-Dokumentation erfahren Sie, wie Sie den Stream in Python und anderen Sprachen lesen. Fehler, die während der Abfrageausführung oder beim Streaming aufgetreten sind, befinden sich in einer zusätzlichen Spalte am Ende mit dem Namen "PQ Arrow Metadata". Medientyp: "application/vnd.apache.arrow.stream"
202 Accepted		Anforderung akzeptiert, Abfrageausführung wird ausgeführt. Header Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Der Dienstratengrenzwert wurde überschritten. Der Server gibt einen Retry-After Header zurück, der in Sekunden angibt, wie lange der Client warten muss, bevor zusätzliche Anforderungen gesendet werden. Header Retry-After: integer
Other Status Codes	ErrorResponse	Häufige Fehlercodes: DataflowExecuteQueryError – Fehler bei der Abfrageausführung. Einige mögliche Gründe sind: Der angegebene Abfragename ist ungültig oder leer, das benutzerdefinierte Mashupdokument ist ungültig, oder der angegebene Abfragename wurde im Datenfluss nicht gefunden (oder im benutzerdefinierten Mashupdokument, falls angegeben).

Definitionen

Name	Beschreibung
ErrorRelatedResource	Das Fehlerbezogene Ressourcendetails-Objekt.
ErrorResponse	Die Fehlerantwort.
ErrorResponseDetails	Die Fehlerantwortdetails.
ExecuteQueryRequest	Anforderungsnutzlast zum Ausführen einer Abfrage für einen Datenfluss.

ErrorRelatedResource

Objekt

Das Fehlerbezogene Ressourcendetails-Objekt.

Name	Typ	Beschreibung
resourceId	string	Die Ressourcen-ID, die an dem Fehler beteiligt ist.
resourceType	string	Der Typ der Ressource, die an dem Fehler beteiligt ist.

ErrorResponse

Objekt

Die Fehlerantwort.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
moreDetails	ErrorResponseDetails[]	Liste der zusätzlichen Fehlerdetails.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.
requestId	string (uuid)	ID der Anforderung, die dem Fehler zugeordnet ist.

ErrorResponseDetails

Objekt

Die Fehlerantwortdetails.

Name	Typ	Beschreibung
errorCode	string	Ein bestimmter Bezeichner, der Informationen über eine Fehlerbedingung bereitstellt und eine standardisierte Kommunikation zwischen unserem Dienst und seinen Benutzern ermöglicht.
message	string	Eine lesbare Darstellung des Fehlers.
relatedResource	ErrorRelatedResource	Die fehlerbezogenen Ressourcendetails.

ExecuteQueryRequest

Objekt

Anforderungsnutzlast zum Ausführen einer Abfrage für einen Datenfluss.

Name	Typ	Beschreibung
customMashupDocument	string	Optionales benutzerdefiniertes Mashupdokument zum Überschreiben des Standardmäßigen Mashups des Datenflusses.
queryName	string	Der Name der Abfrage, die aus dem Datenfluss ausgeführt werden soll (oder aus dem benutzerdefinierten Mashupdokument, sofern angegeben).