Asynchrone Abfrage ausführen

Version 3.1.23.2

Asynchrone Abfrageaufgabe erstellen

Erstellt eine Abfrageaufgabe (Job), um eine zuvor erstellte Abfrage asynchron auszuführen. Gibt eine ID einer Abfrageaufgabe zurück.

Verwenden Sie query_task(query_task_id), um den Ausführungsstatus der Abfrageaufgabe zu prüfen. Wenn der Status der Abfrageaufgabe „Abgeschlossen“ ist, verwenden Sie query_task_results(query_task_id), um die Ergebnisse der Abfrage abzurufen.

Anfrage

POST /query_tasks
Datentyp
Beschreibung
Anfrage
HTTPRequest
body
HTTP-Text
HTTPBody-Definition maximieren...
body
Abfrageparameter
CreateQueryTask-Definition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
Abfrage-ID
integer
ID der auszuführenden Abfrage
Ergebnisformat
String
Gewünschtes asynchrones Abfrageergebnisformat. Gültige Werte sind: „inline_json“, „json“, „json_detail“, „json_fe“, „csv“, „html“, „md“, „txt“, „XLSx“, „gsxml“.
source
String
Quelle der Abfrageaufgabe
zurückgestellt
boolean
Aufgabe erstellen, Ausführung verschieben
Look_ID
integer
ID der mit der Abfrage verknüpften Look.
Dashboard-ID
String
ID des mit der Abfrage verknüpften Dashboards.
Abfrage
HTTP-Abfrage
HTTPQuery-Definition maximieren...
Limit
integer
Zeilenlimit (kann das Limit in der gespeicherten Abfrage überschreiben)
"formatieren" anwenden
boolean
Modellspezifische Formatierung auf jedes Ergebnis anwenden
"bewerben"
boolean
Visualisierungsoptionen auf Ergebnisse anwenden.
Cache
boolean
Ergebnisse aus dem Cache abrufen, falls verfügbar.
Filter_Links_erzeugen
boolean
Generieren Sie Deeplink-Links (nur für das „json_detail“-Format verfügbar).
Erzwungene Produktion
boolean
Erzwingen Sie die Verwendung von Produktionsmodellen, auch wenn sich der Nutzer im Entwicklungsmodus befindet. Dieses Flag auf „false“ bedeutet nicht, dass Entwicklungsmodelle verwendet werden.
nur im Cache
boolean
Rufen Sie Ergebnisse aus dem Cache ab, auch wenn die Ergebnisse abgelaufen sind.
Pfadpräfix
String
Präfix, das für Drilllinks verwendet werden soll (URL-codiert).
PDT_neu.
boolean
Erstellen Sie den in der Abfrage verwendeten PDTS neu.
server_calcs
boolean
Tabellenberechnungen für Abfrageergebnisse durchführen
Bildbreite
integer
Renderingbreite für Bildformate
Bildhöhe
integer
Renderinghöhe für Bildformate
Felder
String
Angeforderte Felder

Antwort

200: Suchanfrage

Datentyp
Beschreibung
(Objekt)
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
id
String
Eindeutige ID
Abfrage-ID
integer
ID der Suchanfrage
Abfrage
Abfrage
Abfragedefinition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
id
integer
Eindeutige ID
model
String
Modell
Ansicht
String
Name untersuchen
Felder
String[]
Pivots
String[]
Felder ausfüllen
String[]
Filter
Objekt
Filter
Filterausdruck
String
Filterausdruck
sortieren
String[]
Limit
String
Limit
Spaltenlimit
String
Spaltenlimit
Summe
boolean
Gesamt
Zeile_gesamt
String
Rohsumme
Zwischensummen
String[]
vis_config
Objekt
Attribute für die Visualisierungskonfiguration. Diese Eigenschaften sind in der Regel undurchsichtig und unterscheiden sich je nach Art der verwendeten Visualisierung. Es ist kein Satz zulässiger Schlüssel angegeben. Die Werte können von JSON unterstützt werden. Ein „Typ“-Schlüssel mit einem Stringwert ist häufig vorhanden und wird von Looker verwendet, um zu bestimmen, welche Visualisierung vorhanden ist. In Visualisierungen werden unbekannte vis_config-Attribute ignoriert.
Filterkonfiguration
Objekt
„filter_config“ stellt den Status der Filter-UI auf der Seite „Erkunden“ für eine bestimmte Abfrage dar. Wenn Sie eine Abfrage über die Looker-UI ausführen, hat dieser Parameter Vorrang vor „Filtern“. Wenn Sie eine Abfrage erstellen oder eine vorhandene Abfrage ändern, muss „filter_config“ auf null gesetzt werden. Wenn Sie einen anderen Wert festlegen, kann das zu unerwartetem Filterverhalten führen. Das Format sollte als undurchsichtig betrachtet werden.
sichtbare_Bereich_UIs
String
Sichtbare UI-Abschnitte
Slug
String
Slug
dynamische Felder
String
Dynamische Felder
client_id
String
Client-ID: wird zum Generieren von gekürzten URLs für die explorative Datenanalyse verwendet. Wenn dies vom Client festgelegt wird, muss dies ein eindeutiger alphanumerischer String mit 22 Zeichen sein. Andernfalls wird eine ID generiert.
URL teilen
String
URL teilen
erweiterte_freigabe_url
String
URL der erweiterten Freigabe
URL
String
Erweiterte URL
Abfragezeitzone
String
Zeitzone der Abfrage
Has_table_calculations
boolean
Mit Tabellenberechnungen
runtime
Zahl
(VERWORFEN) Laufzeit (eingestellt)
Links erstellen
boolean
ob Links in der Abfrageantwort generiert werden.
Erzwungene Produktion
boolean
Verwenden Sie Produktionsmodelle, um die Abfrage auszuführen (auch wenn sich der Nutzer im Entwicklermodus befindet).
Pfadpräfix
String
Präfix, das für Drilllinks verwendet werden soll.
Cache
boolean
Informationen dazu, ob der Cache verwendet werden soll
server_calcs
boolean
Festlegen, ob Tabellenberechnungen auf dem Server ausgeführt werden sollen
nur im Cache
boolean
Rufen Sie Ergebnisse aus dem Cache ab, auch wenn die Ergebnisse abgelaufen sind.
Cache-Schlüssel
String
Cache-Schlüssel zum Zwischenspeichern der Abfrage.
Status
String
Status der Abfrageaufgabe.
source
String
Quelle der Abfrageaufgabe.
runtime
Zahl
Laufzeit vorheriger Abfragen.
PDT_neu.
boolean
Erstellen Sie den in der Abfrage verwendeten PDTS neu.
Ergebnisquelle
String
Quelle der Ergebnisse der Abfrage.
Look_ID
integer
ID der mit der Abfrage verknüpften Look.
Dashboard-ID
String
ID des mit der Abfrage verknüpften Dashboards.
Ergebnisformat
String
Das Datenformat der Abfrageergebnisse.

400: Ungültige Anfrage

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

404: Nicht gefunden

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

409: Ressource ist bereits vorhanden

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

422: Validierungsfehler

Datentyp
Beschreibung
nachricht
String
Fehlerdetails
ValidationErrorDetail-Definition maximieren...
Feld
String
Feld mit Fehler
Code
String
Fehlercode
nachricht
String
Fehlermeldung
Dokumentations-URL
String
Link zur Dokumentation
Dokumentations-URL
String
Link zur Dokumentation

429: Zu viele Anfragen

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

Beispiele