Stai visualizzando la documentazione per Looker 22.16. La documentazione più recente è disponibile qui.

query

Questa pagina si riferisce al parametro query che fa parte di un'esplorazione.

query può essere utilizzato anche come parte di una tabella aggregata, come descritto nella pagina della documentazione relativa al parametro aggregate_table.

Utilizzo

Presentazione dell'intervallo di 8 minuti di metta in evidenza

Gerarchia

File modello

explore

query

Valore predefinito

Nessuna

Accetta

Il nome della query e dei sottoparametri per definire la query

Definizione

Puoi utilizzare il parametro query per creare analisi modellate per un'esplorazione. Le analisi modellate sono elencate nella sezione Avvio rapido di un'esplorazione vuota o nel popup Avvio rapido dopo che un'esplorazione è già stata eseguita. Per scoprire come funziona, consulta la sezione Esempio di questa pagina.

Le analisi modellate sono utili per gli utenti principianti di Looker poiché possono specificare elementi come dimensioni, misure, filtri e pivot che possono essere più pertinenti e approfonditi.

Definizione di una query in LookML

Anziché creare il LookML della query da zero, puoi utilizzare Esplora per creare il LookML di base della query per te. Per i dettagli, consulta la sezione successiva, Recupero della query LookML da un'esplorazione.

Il parametro query ha i seguenti sottoparametri:

Nome parametro	Descrizione	Esempio
`label`	Facoltativamente, aggiunge un'etichetta per `query`. L'etichetta viene visualizzata nel selettore di campi di Explore (Esplora) della query.	`label: "Weekly Sales Totals"`
`description`	Facoltativamente, aggiungi una descrizione di questa query per informare gli utenti. In Esplora, le query con una descrizione saranno contrassegnate da un'icona informativa. Il testo della descrizione viene visualizzato quando un utente posiziona il puntatore del mouse sopra l'icona delle informazioni.	`description: "Total value of all sales per day"`
`dimensions`	Un elenco separato da virgole di dimensioni dalla sezione Esplora da includere nella query. Il campo `dimensions` utilizza questa sintassi: `dimensions: [dimension1, dimension2, ...]`	`dimensions: [orders.created_month, orders.country]`
`measures`	Un elenco separato da virgole di misure dalla sezione Esplora da includere nella query. Il campo `measures` utilizza questa sintassi: `measures: [measure1, measure2, ...]`	`measures: [orders.count]`
`filters`	Facoltativamente, puoi aggiungere filtri a `query`. I filtri vengono aggiunti alla clausola `WHERE` dell'SQL che genera la query. Il campo `filters` utilizza questa sintassi: `filters: [field_name_1: "value1", field_name_2: "value2", ...]`	`filters: [orders.country: "United States", orders.state: "California"]`
`limit`	Facoltativamente, specifica il limite di righe della query.	`limit: 10`
`sorts`	Facoltativamente, puoi specificare i campi di ordinamento e la direzione di ordinamento (in ordine crescente o decrescente) per `query`. Il campo `sorts` utilizza questa sintassi: `sorts: [field1: asc\|desc, field2: asc\|desc, ...]`	`sorts: [order_items.total_sales: asc]`
`pivots`	Facoltativamente, puoi ruotare i risultati in base alle dimensioni specificate della query. Il campo `pivots` utilizza questa sintassi: `pivots: [dimension1, dimension2, ...]` NOTA: i campi specificati nel parametro `pivots` devono essere specificati anche nel parametro `dimensions` della query.	`pivots: [created_quarter]`
`timezone`	Non supportato Il parametro `timezone` non è supportato per il parametro `query` che è un sottoparametro di `explore`. `query` in `explore` utilizza lo stesso fuso orario utilizzato da `explore`.

Recupero della query LookML da un'esplorazione

In alternativa, gli sviluppatori Looker possono utilizzare la funzionalità utilizzata per generare LookML aggregate_table da Explore (Esplora), quindi copiare la query aggregata della tabella LookML e utilizzarla come punto di partenza per l'analisi modellata LookML.

Quando copi LookML per una tabella aggregata, copi anche alcuni parametri indesiderati per la tua query modellata LookML. In particolare, una volta copiata la tabella LookML aggregata, devi eliminare i parametri aggregate_table e materialization, poiché si applicano solo alle tabelle aggregate. Per ulteriori informazioni su questi parametri, consulta la pagina della documentazione relativa al parametro aggregate_table.

Inoltre, il parametro della tabella aggregata query supporta solo un sottoinsieme dei parametri supportati dalle query di Explore modellate. Ciò significa che, dopo aver copiato la tabella aggregata query LookML, puoi utilizzare parametri aggiuntivi per la query modellata. Consulta la sezione Definizione di una query in LookML in questa pagina per un elenco completo dei parametri supportati per le query modellate.

Per utilizzare un'esplorazione per ottenere una base per la tua query LookML modellata:

In Esplora, seleziona tutti i campi e i filtri da includere nella query modellata.
Fai clic su Esegui per ottenere i risultati.
Seleziona Get LookML (Seleziona LookML) dal menu Explore (Esplora). Questa opzione è disponibile solo per gli sviluppatori Looker.
Fai clic sulla scheda Tabella aggregata.
Looker fornisce il perfezionamento LookML per un Explore per una tabella aggregata. Possiamo utilizzare il LookML query della tabella aggregata e modificarlo per una query Explore modellata. Copia il codice LookML e incollalo nel file di modello associato, come indicato nel commento sopra il perfezionamento Esplora. Se l'esplorazione è definita in un file Explore separato e non in un file modello, puoi aggiungere il perfezionamento al file dell'esplorazione anziché al file del modello.

Da qui, puoi modificare la tabella aggregata LookML da utilizzare per una query modellata:
Conserva solo il parametro query e i relativi sottoparametri. Elimina i parametri aggregate_table e materialization, dato che si applicano solo alle tabelle aggregate.
Aggiungi un nome per la query. Come mostrato nella sezione Esempio di questa pagina, la sintassi è:
query: query_name
(Facoltativo) Compila eventuali altri parametri per la query modellata. Per un elenco completo dei parametri supportati per le query modellate, consulta la sezione Definizione di una query in LookML in questa pagina.

Esempio

Questo esempio crea una query modellata order_count_by_month per l'esplorazione order_items:


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

L'analisi viene quindi visualizzata nella sezione Guida rapida in Esplora gli articoli vuoti. Seleziona l'analisi dalla sezione Guida rapida per eseguire l'analisi in Esplora:

Una volta eseguita l'analisi modellata in Esplora, puoi esaminare i dati così come sono oppure utilizzare l'analisi come punto di partenza per aggiungere altri campi e misure, modificare i filtri, creare visualizzazioni o eseguire qualsiasi altra azione per esplorare i tuoi dati in Looker. Puoi anche fare clic sull'icona del lampo accanto al nome Esplora:

Viene visualizzato il popup Avvio rapido, in cui puoi selezionare una nuova analisi:

Seleziona un'analisi Avvio rapido per eseguire l'analisi e sostituire i risultati Esplora precedenti precedenti mantenendo i filtri esistenti. Per ulteriori dettagli sul comportamento dei filtri con le analisi di avvio rapido, consulta la sezione Comportamento dei filtri di avvio rapido nella pagina della documentazione Esplorazione dei dati in Looker.