Asynchrone Abfrageergebnisse abrufen

Version 3.1.23.2

Asynchrone Abfrageergebnisse abrufen

Gibt die Ergebnisse einer asynchronen Abfrageaufgabe zurück, wenn die Abfrage abgeschlossen ist.

Wenn die Abfrageaufgabe noch läuft oder darauf wartet, dass sie ausgeführt wird, gibt diese Funktion den Status „204 No Content“ zurück.

Wenn die ID der Abfrageaufgabe ungültig ist oder die im Cache gespeicherten Ergebnisse der Abfrageaufgabe abgelaufen sind, gibt diese Funktion „404 Nicht gefunden“ zurück.

Verwenden Sie query_task(query_task_id), um den Ausführungsstatus der Abfrageaufgabe zu prüfen. Rufen Siequery_task_results erst auf, wenn der Status der Abfrageaufgabe "Abgeschlossen" erreicht hat.

Sie können auch query_task_multi_results() verwenden, um die Ergebnisse mehrerer asynchroner Abfrageaufgaben gleichzeitig abzurufen.

SQL-Fehlerbehandlung:

Wenn die Abfrage aufgrund eines SQL-DB-Fehlers fehlschlägt, hängt davon ab, wie dies kommuniziert wird. Dies hängt vom Ergebnisergebnis ab, das Sie in create_query_task() angefordert haben.

Bei json_detail-Ergebnisformat: query_task_results() antwortet mit dem HTTP-Status „200 OK“. Außerdem sind db SQL-Fehlerinformationen im Attribut errors des Antwortobjekts zu finden. Das Attribut „Daten“ ist leer.

Bei allen anderen Ergebnisformaten wird query_task_results() mit dem HTTP-Status 400 Bad Request zurückgegeben und einige db SQL-Fehlerinformationen werden in der Nachricht der 400-Fehlerantwort angezeigt, aber nicht so detailliert wie in json_detail.errors. Diese Datenformate können nur Zeilendaten enthalten. Fehlerinformationen sind keine Zeilendaten.

Anfrage

GET /query_tasks/{query_task_id}/results
Datentyp
Beschreibung
Anfrage
HTTPRequest
Pfad
HTTPPath
HTTPPath-Definition maximieren...
Abfrage-ID
String
ID der Abfrageaufgabe

Antwort

200: Die Abfrageergebnisse.

Datentyp
Beschreibung
(String)
String

204: Die Abfrage ist nicht abgeschlossen

Datentyp
Beschreibung
(String)
String

400: Ungültige Anfrage

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

404: Die ID der Abfrageaufgabe wurde nicht gefunden oder die Ergebnisse sind abgelaufen.

Datentyp
Beschreibung
(Objekt)
nachricht
String
Fehlerdetails
Dokumentations-URL
String
Link zur Dokumentation

Beispiele