Esegui query asincrona

Versione 4.0.23.2

Crea un'attività di query asincrona

Crea un'attività di query (job) per eseguire in modo asincrono una query creata in precedenza. Restituisce un ID attività query.

Utilizza query_task(query_task_id) per controllare lo stato di esecuzione dell'attività di query. Dopo aver raggiunto lo stato "Completato", utilizza query_task_results(query_task_id) per recuperare i risultati della query.

Richiesta

POST /query_tasks
Tipo di dati
Descrizione
Richiesta
HTTPRequest
body
HTTPBody
Espandi definizione HTTPBody...
body
Parametri di ricerca
Espandi definizione CreateQueryTask...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id_query
string
ID della query da eseguire
formato_risultato
string
Formato dei risultati della query asincrona desiderato. I valori validi sono: "inline_json", "json", "json_detail", "json_fe", "csv", "html", "md", "txt", "xlsx", "gsxml".
origine
string
Origine dell'attività di query
deferred
boolean
Crea l'attività, ma rimanda l'esecuzione
look_id
string
ID dell'aspetto associato alla query.
ID_dashboard
string
ID della dashboard associata alla query.
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.
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
larghezza_immagine
integer
OBSOLETO. Larghezza rendering per i formati dell'immagine. Tieni presente che questo parametro viene sempre ignorato da questo metodo.
altezza_immagine
integer
OBSOLETO. Altezza di rendering per i formati dell'immagine. Tieni presente che questo parametro viene sempre ignorato da questo metodo.
campi
string
Campi richiesti

Risposta

200: query_task

Tipo di dati
Descrizione
(oggetto)
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
ID univoco
id_query
string
ID della query
della query
Query
Espandi definizione query...
può
oggetto
Operazioni che l'utente corrente può eseguire su questo oggetto
id
string
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
generare_link
boolean
se generare o meno link nella risposta della query.
forza_produzione
boolean
Utilizza i modelli di produzione per eseguire la query (anche se l'utente è in modalità sviluppatore).
prefisso_percorso
string
Prefisso da utilizzare per i link di visualizzazione.
cache
boolean
Se utilizzare o meno la cache
cal_tab_server
boolean
Se eseguire o meno i calcoli tabulari sul server.
solo cache
boolean
Recupera tutti i risultati dalla cache anche se sono scaduti.
chiave_cache
string
Chiave cache utilizzata per memorizzare la query.
stato
string
Stato dell'attività di query.
origine
string
Origine dell'attività di query.
runtime
number
Durata delle query precedenti.
ricostruzione_pdts
boolean
Ricrea le PDTS utilizzate nella query.
origine_risultato
string
L'origine dei risultati della query.
look_id
string
ID dell'aspetto associato alla query.
ID_dashboard
string
ID della dashboard associata alla query.
formato_risultato
string
Il formato dei dati dei risultati della query.

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

409: Risorsa già esistente

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