URL-codierte Abfrage ausführen

Version 4.0.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)
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

C#

https://github.com/looker-open-source/sdk-codegen/blob/main/csharp/sdk/3.1/methods.cs
https://github.com/looker-open-source/sdk-codegen/blob/main/csharp/sdk/4.0/methods.cs

Einfach loslegen (Go)

https://github.com/looker-open-source/sdk-codegen/blob/main/go/sdk/v4/methods.go

Kotlin

https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/main/com/looker/sdk/4.0/methods.kt
https://github.com/looker-open-source/sdk-codegen/Blob/main/kotlin/src/main/com/looker/sdk/4.0/streams.kt

TypeScript

https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk/src/3.1/funcs.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk/src/3.1/methods.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk/src/3.1/methodsInterface.ts
https://github.com/looker-open-source/sdk-codegen/Blob/main/packages/sdk/src/3.1/streams.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk/src/4.0/funcs.ts
https://github.com/looker-open-source/sdk-codegen/Blob/main/packages/sdk/src/4.0/methods.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk/src/4.0/methodsInterface.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk/src/4.0/streams.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-codegen/src/python.gen.spec.ts

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/python/looker_sdk/sdk/api31/methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/looker_sdk/sdk/api40/methods.py

Swift

https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/sdk/methods.swift
https://github.com/looker-open-source/sdk-codegen/Blob/main/swift/looker/sdk/streams.swift