Abfrage erstellen

Version 4.0.23.6 (neueste Version)

Erstellen Sie eine Abfrage.

So können Sie eine neue Abfrage erstellen, die Sie später ausführen können. Looker-Abfragen sind nach der Erstellung unveränderlich und werden nicht gelöscht. Wenn Sie eine Abfrage erstellen, die einer vorhandenen Abfrage genau entspricht, wird die vorhandene Abfrage zurückgegeben und keine neue Abfrage erstellt. Unabhängig davon, ob eine neue Abfrage erstellt wird oder nicht, können Sie das „id“ in der zurückgegebenen Abfrage mit der Methode „run“ verwenden.

Die Abfrageparameter werden im Text der Anfrage als JSON-Datei übergeben.

Anfrage

POST /queries
Datentyp
Beschreibung
Anfrage
HTTPRequest
body
HTTP-Text
HTTPBody-Definition maximieren...
body
Abfrage
Abfragedefinition maximieren...
kann
Objekt
Vorgänge, die der aktuelle Nutzer für dieses Objekt ausführen kann
id
String
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
Abfrage
HTTP-Abfrage
HTTPQuery-Definition maximieren...
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
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

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

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py

Ruby

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/ruby/update_look.rb

Kotlin

https://github.com/looker-open-source/sdk-codegen/Blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/Blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/Blob/main/kotlin/src/test/TestSmoke.kt

TypeScript

https://github.com/looker-open-source/sdk-codegen/Blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/Blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/Blob/main/packages/sdk-node/test/methods.spec.ts

Swift

https://github.com/looker-open-source/sdk-codegen/Blob/main/swift/looker/Tests/lookerTests/smokeTests.swift
https://github.com/looker-open-source/sdk-codegen/Blob/main/swift/looker/Tests/lookerTests/smokeTests.swift