Crea query

Versione 4.0.23.6 (più recente)

Creare una query.

In questo modo puoi creare una nuova query da eseguire in un secondo momento. Una volta create, le query Looker sono immutabili e non vengono eliminate. Se crei una query che è esattamente come una esistente, viene restituita la query esistente e non viene creata una nuova query. Indipendentemente dal fatto che una nuova query sia stata creata o meno, puoi utilizzare "id" nella query restituita con il metodo "run".

I parametri di ricerca vengono passati come json nel corpo della richiesta

Richiesta

POST /query
Tipo di dati
Descrizione
Richiesta
HTTPRequest
body
HTTPBody
Espandi definizione HTTPBody...
body
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
della query
Query HTTP
Espandi definizione HTTPQuery in corso...
campi
string
Campi richiesti:

Risposta

200: query

Tipo di dati
Descrizione
(oggetto)
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

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

Python

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/examples/python/query_task.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py
https://github.com/looker-open-source/sdk-codegen/blob/main/python/tests/integration/test_methods.py

Ruby

https://github.com/looker-open-source/sdk-codegen/blob/main/examples/ruby/update_look.rb

Kotlin

https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestMethods.kt
https://github.com/looker-open-source/sdk-codegen/blob/main/kotlin/src/test/TestSmoke.kt

TypeScript

https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts
https://github.com/looker-open-source/sdk-codegen/blob/main/packages/sdk-node/test/methods.spec.ts

Swift

https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift
https://github.com/looker-open-source/sdk-codegen/blob/main/swift/looker/Tests/lookerTests/smokeTests.swift