Esegui query in linea

Versione 3.1.23.2

Eseguire la query specificata in linea nel corpo pubblicato.

Ciò consente di eseguire una query come definito in json nel corpo pubblicato. che combina le due azioni di pubblicazione ed esecuzione di una query in un unico passaggio.

Ecco un corpo di esempio in formato 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"
}

Quando si utilizza l'SDK Ruby, questo viene trasmesso come hash Ruby, come:

{
 :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",
}

Verrà restituito il risultato dell'esecuzione della query nel formato specificato dal parametro "result_format".

Formati supportati:

formato_risultato Descrizione
json JSON semplice
json_dettaglio Dati sulle righe più metadati che descrivono i campi, i pivot, le tabelle dei calcoli e altri aspetti della query
csv Valori separati da virgola con un'intestazione
file txt Valori separati da tabulazione con un'intestazione
html HTML semplice
md Markdown semplice
xlsx Foglio di lavoro MS Excel
sql Restituisce l'SQL generato anziché eseguire la query
PNG Un'immagine PNG della visualizzazione della query
JPG Un'immagine JPG della visualizzazione della query

Richiesta

POST /queries/run/{result_format}
Tipo di dati
Descrizione
Richiesta
HTTPRequest
percorso
Percorso HTTP
Espandi definizione HTTPPath...
formato_risultato
string
Formato del risultato
body
HTTPBody
Espandi definizione HTTPBody...
body
query in linea
Espandi definizione query...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
integer
ID univoco
modello
string
Modello
vista
string
Nome esplorazione
campi
stringa[]
colonne pivot
stringa[]
campi_riempimento
stringa[]
filters
oggetto
Filtri
espressione_filtro
string
Espressione di filtro
ordina
stringa[]
limite
string
Limite
limite_colonna
string
Limite di colonne
totale
boolean
Total (Totale)
riga_totale
string
Totale non elaborato
subtotali
stringa[]
configurazione_vis
oggetto
Proprietà di configurazione della visualizzazione. Queste proprietà sono in genere opache e variano in base al tipo di visualizzazione usato. Non esiste un insieme specificato di chiavi consentite. I valori possono essere di qualsiasi tipo supportati dal formato JSON. È spesso presente una chiave "type" con valore stringa e utilizzata da Looker per determinare quale visualizzazione presentare. Le visualizzazioni ignorano le proprietà vis_config sconosciute.
configurazione_filtro
oggetto
Il filtro_config rappresenta lo stato dell'interfaccia utente del filtro nella pagina di esplorazione per una determinata query. Quando esegui una query tramite l'interfaccia utente di Looker, questo parametro ha la precedenza sui "filtri". Quando crei una query o ne modifichi una esistente, il filtro "filter_config" deve essere impostato su null. L'impostazione di qualsiasi altro valore potrebbe causare comportamenti di filtro imprevisti. Il formato deve essere considerato opaco.
sezioni_UI_visibili
string
Sezioni dell'interfaccia utente visibili
lumaca
string
Slug
campi_dinamici
string
Campi dinamici
client_id
string
ID client: utilizzato per generare URL di esplorazione abbreviati. Se impostato dal client, deve essere una stringa alfanumerica di 22 caratteri univoca. In caso contrario, ne verrà generato uno.
url_condivisione
string
Condividi URL
URL_condivisione_espanso
string
URL di condivisione espanso
url
string
URL espanso
fuso orario query
string
Fuso orario query
Has_table_calculations
boolean
Con calcoli tabulari
runtime
number
(DEPRECATO) Runtime (deprecato)
della query
Query HTTP
Espandi definizione HTTPQuery in corso...
limite
integer
Limite di righe (può sostituire il limite nella query salvata).
applica_formattazione
boolean
Applica la formattazione specificata dal modello a ciascun risultato.
applica_vis
boolean
Applica le opzioni di visualizzazione ai risultati.
cache
boolean
Ricevere risultati dalla cache, se disponibili.
larghezza_immagine
integer
Larghezza rendering per i formati dell'immagine.
altezza_immagine
integer
Altezza di rendering per i formati dell'immagine.
generare_link_drill
boolean
Genera link di drill (applicabile solo al formato "json_detail").
forza_produzione
boolean
Forza l'uso dei modelli di produzione anche se l'utente è in modalità sviluppo. Tieni presente che questo flag non è garantito che non verranno utilizzati modelli di sviluppo.
solo cache
boolean
Recupera tutti i risultati dalla cache anche se sono scaduti.
prefisso_percorso
string
Prefisso da utilizzare per i link a drill (codificato nell'URL).
ricostruzione_pdts
boolean
Ricrea le PDTS utilizzate nella query.
cal_tab_server
boolean
Esecuzione di calcoli tabulari sui risultati delle query

Risposta

200: risultato della query

Tipo di dati
Descrizione
(stringa)
string

400: Richiesta errata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

404: Non trovata

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

422: Errore di convalida

Tipo di dati
Descrizione
messaggio
string
Error details (Dettagli errore)
Espandi definizione ValidationErrorDetails...
campo
string
Campo con errore
codice
string
Codice di errore
messaggio
string
Messaggio informativo sull'errore
documentazione_url
string
Link alla documentazione
documentazione_url
string
Link alla documentazione

429: Troppe richieste

Tipo di dati
Descrizione
(oggetto)
messaggio
string
Error details (Dettagli errore)
documentazione_url
string
Link alla documentazione

Esempi