query

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

query può essere utilizzato anche nell'ambito di una tabella aggregata, come descritto nella pagina della documentazione dedicata al parametro aggregate_table.

Utilizzo

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
Gerarchia
explore
query
Valore predefinito
Nessuno

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 l'esecuzione di un'esplorazione. Per capire come funziona, consulta la sezione Esempio in questa pagina.

Le analisi modellate sono utili per gli utenti di Looker alle prime armi, in quanto puoi specificare elementi come dimensioni, misure, filtri e tabelle pivot che potrebbero essere i più pertinenti e utili.

Definizione di una query in LookML

Anziché creare il codice LookML della query da zero, puoi utilizzare un'esplorazione per creare il codice LookML di base della query. Per maggiori dettagli, consulta la sezione successiva, Recuperare il codice LookML di una query da un'esplorazione.

Il parametro query ha i seguenti sottoparametri:

Nome parametro Descrizione Esempio
label (Facoltativo) Aggiunge un'etichetta per query. L'etichetta è ciò che viene visualizzato nel selettore di campi di Esplora per la query. label: "Weekly Sales Totals"
description (Facoltativo) Aggiunge una descrizione di questa query per informare gli utenti. Nella sezione Esplora, le query con una descrizione avranno un'icona informativa. Il testo della descrizione viene visualizzato quando un utente passa il mouse sopra l'icona delle informazioni. description: "Total value of all sales per day"
dimensions Un elenco separato da virgole delle dimensioni di 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 delle misure dell'esplorazione da includere nella query. Il campo measures utilizza questa sintassi:

measures: [measure1, measure2, ...] 		measures:

  [orders.count]
filters (Facoltativo) Aggiunge filtri a un 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 Specifica facoltativamente il limite di righe della query. limit: 10
sorts (Facoltativo) Specifica i campi di ordinamento e la direzione di ordinamento (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 (Facoltativo) Inverte i risultati in base alle dimensioni specificate della query. Il campo pivots utilizza questa sintassi:

pivots: [dimension1, dimension2, ...]

NOTE: 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. Un query in explore utilizza lo stesso fuso orario utilizzato da explore.

Recuperare il codice LookML di una query da un'esplorazione

Come scorciatoia, gli sviluppatori Looker possono prendere in prestito la funzionalità utilizzata per generare il codice LookML aggregate_table da un'esplorazione, quindi copiare il codice LookML della query della tabella aggregata e utilizzarlo come punto di partenza per il codice LookML di analisi modellata.

Quando copi il codice LookML per una tabella aggregata, copi anche alcuni parametri che non ti interessano per il codice LookML della query modellata. Nello specifico, una volta copiato il codice LookML della tabella aggregata, devi eliminare i parametri aggregate_table e materialization, poiché si applicano solo alle tabelle aggregate. Per saperne di più su questi parametri, consulta la pagina della documentazione del parametro aggregate_table.

Inoltre, il parametro della tabella aggregata query supporta solo un sottoinsieme dei parametri supportati dalle query di esplorazione modellate. Ciò significa che, una volta copiato il codice LookML della tabella aggregata query, puoi utilizzare parametri aggiuntivi 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.

Per utilizzare un'esplorazione per ottenere una base per il LookML della query modellata:

  1. Nell'esplorazione, seleziona tutti i campi e i filtri da includere nella query modellata.
  2. Seleziona Esegui per ottenere i risultati.

  3. Seleziona Ottieni LookML dal menu a forma di ingranaggio Azioni esplorazione. Questa opzione è disponibile solo per gli sviluppatori di Looker.

  4. Seleziona la scheda Tabella aggregata.

  5. Looker fornisce il codice LookML per un miglioramento di Esplora per una tabella aggregata. Possiamo utilizzare il codice query LookML della tabella aggregata e modificarlo per una query Esplora modellata. Copia il codice LookML e incollalo nel file del modello associato, indicato nel commento che precede il perfezionamento dell'esplorazione. Se l'esplorazione è definita in un file di esplorazione separato e non in un file del modello, puoi aggiungere il perfezionamento al file dell'esplorazione anziché al file del modello.

    Da qui, puoi modificare il codice LookML della tabella aggregata da utilizzare per una query modellata:

  6. Conserva solo il parametro query e i relativi parametri secondari. Elimina i parametri aggregate_table e materialization, poiché si applicano solo alle tabelle aggregate.

  7. Aggiungi un nome per la query. Come mostrato nella sezione Esempio di questa pagina, la sintassi è:

    query: query_name

  8. (Facoltativo) Compila eventuali parametri aggiuntivi 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"]
    }
  }

Gli utenti possono eseguire l'analisi Avvio rapido dalla sezione Avvio rapido dell'esplorazione Elementi ordine.