URL-codierte Abfrage ausführen

Version 3.1.23.2

Führen Sie eine URL-codierte Abfrage aus.

Dazu muss der Aufrufer die Spezifizierer für die Abfrage mit der Looker-spezifischen Syntax in der URL-Abfrage codieren, wie unten erläutert.

Im Allgemeinen sollten Sie eine der Methoden verwenden, die die Parameter als JSON im POST-Text zum Erstellen und/oder Ausführen von Abfragen verwenden. Diese Methode ist vorhanden, wenn einer der Parameter wirklich in die URL einer einzelnen GET-Anfrage codiert werden muss. Dies entspricht der Formatierung der URLs für „Erkunden“ in der Looker-UI.

Die Parameter ähneln der JSON-Textformatierung, außer dass die Filtersyntax kompliziert ist. Leider ist dieses Format derzeit nicht über die Schaltfläche „Jetzt testen“ auf dieser Dokumentationsseite aufrufbar. Sie ist aber beim manuellen Erstellen von URLs oder bei Verwendung des Looker SDK aufrufbar.

Hier ein Beispiel für eine Inline-Abfrage-URL:

https://looker.mycompany.com:19999/api/3.0/queries/models/thelook/views/inventory_items/run/json?fields=category.name,inventory_items.days_in_inventory_tier,products.count&f[category.name]=socks&sorts=products.count+desc+0&limit=500&query_timezone=America/Los_Angeles

Wenn Sie diesen Endpunkt mit dem Ruby SDK aufrufen, übergeben Sie die Suchparameterteile als Hash. Der Hash, der mit dem Obenstehenden übereinstimmt, würde folgendermaßen aussehen:

query_params =
{
  fields: "category.name,inventory_items.days_in_inventory_tier,products.count",
  :"f[category.name]" => "socks",
  sorts: "products.count desc 0",
  limit: "500",
  query_timezone: "America/Los_Angeles"
}
response = ruby_sdk.run_url_encoded_query('thelook','inventory_items','json', query_params)

Auch hier ist es in der Regel einfacher, die Variante dieser Methode zu verwenden, die die vollständige Abfrage im POST-Text übergeben. Diese Methode ist verfügbar, wenn andere Alternativen nicht den Anforderungen entsprechen.

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

GET /queries/models/{model_name}/views/{view_name}/run/{result_format}

Datentyp

Beschreibung

Anfrage

HTTPRequest

Pfad

HTTPPath

HTTPPath-Definition maximieren...

model_name

String

Modellname

Ansichtsname

String

Ansichtsname

Ergebnisformat

String

Format des Ergebnisses

Antwort

200: Suchanfrage

Datentyp

Beschreibung

(String)

String

400: Ungültige Anfrage

Datentyp

Beschreibung

(Objekt)

Fehler

nachricht

String

Fehlerdetails

Dokumentations-URL

String

Link zur Dokumentation

404: Nicht gefunden

Datentyp

Beschreibung

(Objekt)

Fehler

nachricht

String

Fehlerdetails

Dokumentations-URL

String

Link zur Dokumentation

422: Validierungsfehler

Datentyp

Beschreibung

(Objekt)

Validierungsfehler

nachricht

String

Fehlerdetails

Fehler

Validierungsfehler[]

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)

Fehler

nachricht

String

Fehlerdetails

Dokumentations-URL

String

Link zur Dokumentation

Beispiele

URL-codierte Abfrage ausführen

Führen Sie eine URL-codierte Abfrage aus.

Anfrage

Antwort

200: Suchanfrage

400: Ungültige Anfrage

404: Nicht gefunden

422: Validierungsfehler

429: Zu viele Anfragen

Beispiele

C#

Einfach loslegen (Go)

Kotlin

TypeScript

Python

Swift