Inline-Abfrage ausführen

Version 4.0.23.6 (neueste Version)

Führen Sie die Abfrage aus, die inline im geposteten Text angegeben ist.

Dies ermöglicht das Ausführen einer Abfrage, die im JSON-Code im veröffentlichten Text definiert ist. Dadurch werden die beiden Aktionen zum Posten und Ausführen einer Abfrage in einem Schritt kombiniert.

Hier ein Beispieltext in JSON:

{
  "model":"thelook",
  "view":"inventory_items",
  "fields":["category.name","inventory_items.days_in_inventory_tier","products.count"],
  "filters":{"category.name":"socks"},
  "sorts":["products.count desc 0"],
  "limit":"500",
  "query_timezone":"America/Los_Angeles"
}

Wenn Sie das Ruby SDK verwenden, wird dies als Ruby-Hash weitergegeben:

{
 :model=>"thelook",
 :view=>"inventory_items",
 :fields=>
  ["category.name",
   "inventory_items.days_in_inventory_tier",
   "products.count"],
 :filters=>{:"category.name"=>"socks"},
 :sorts=>["products.count desc 0"],
 :limit=>"500",
 :query_timezone=>"America/Los_Angeles",
}

So wird das Ergebnis der Ausführung der Abfrage in dem Format zurückgegeben, das im Parameter „result_format“ angegeben wurde.

Unterstützte Formate:

Ergebnisformat Beschreibung
json Einfache JSON-Datei
JSON-Details Zeilendaten plus Metadaten, die die Felder, Pivots, Tabellenkalkulationen und andere Aspekte der Abfrage beschreiben
CSV Kommagetrennte Werte mit einem Header
TXT Tabulatorgetrennte Werte mit einer Überschrift
html Einfaches HTML
MD Einfacher Abzug
xlsx Microsoft Excel-Tabelle
sql den generierten SQL-Code zurückgibt, anstatt die Abfrage auszuführen
PNG Ein PNG-Bild der Visualisierung der Abfrage
jpg Ein JPG-Bild der Visualisierung der Abfrage

Anfrage

POST /queries/run/{Ergebnis_Format}
Datentyp
Beschreibung
Anfrage
HTTPRequest
Pfad
HTTPPath
HTTPPath-Definition maximieren...
Ergebnisformat
String
Format des Ergebnisses
body
HTTP-Text
HTTPBody-Definition maximieren...
body
Inline-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...
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.
Bildbreite
integer
Renderingbreite für Bildformate
Bildhöhe
integer
Renderinghöhe für Bildformate
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

Antwort

200: Abfrageergebnis

Datentyp
Beschreibung
(String)
String

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

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