In costruzione: stiamo lavorando per aggiungere altri contenuti a questa pagina. Nel frattempo, consulta la pagina della documentazione Opzioni del grafico a cronologia per visualizzare informazioni sulla creazione e la modifica dei grafici a cronologia utilizzando il menu delle opzioni di visualizzazione.
I parametri descritti in questa pagina possono essere utilizzati con gli elementi del dashboard LookML di type: looker_timeline in un file dashboard.lkml.
Per informazioni sulla creazione di un grafico a cronologia tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Opzioni del grafico a cronologia.
Parametri di base
Quando definisci un elemento del dashboard LookML, devi specificare i valori per almeno i parametri di base name e type. Altri parametri di base come title, height e width influiscono sull'aspetto e sulla posizione di un elemento in una dashboard.
name
Questa sezione si riferisce al parametro
nameche fa parte di un elemento del dashboard.
namepuò essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Ogni dichiarazione name crea un nuovo elemento della dashboard e gli assegna un nome. I nomi degli elementi devono essere univoci. A volte i nomi vengono citati nel parametro elements quando utilizzi i dashboard layout: grid.
- name: orders_by_date
title
Questa sezione si riferisce al parametro
titleche fa parte di un elemento del dashboard.
titlepuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
titlepuò essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Il parametro title ti consente di modificare il modo in cui il nome di un elemento viene visualizzato dagli utenti. Se non specificato, il titolo corrisponde per impostazione predefinita all'elemento name.
Considera questo esempio:
- name: sales_overview
title: '1) Sales Overview'
Se hai utilizzato questo formato, anziché visualizzare l'elemento come Panoramica delle vendite, lo vedrai come 1) Panoramica delle vendite.
type
Questa sezione si riferisce al parametro
typeche fa parte di un elemento del dashboard.
typepuò essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
typepuò essere utilizzato anche nell'ambito di un'unione, come descritto nella pagina della documentazione relativa al parametrotype(per le unioni).
typepuò essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.
typepuò essere utilizzato anche come parte di una misura, come descritto nella pagina della documentazione Tipi di misure.
Il parametro type determina il tipo di visualizzazione da utilizzare nell'elemento.
- name: element_name
type: text | looker_grid | table | single_value | looker_single_record |
looker_column | looker_bar | looker_scatter | looker_line | looker_area |
looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot
Per una panoramica dei diversi tipi di elementi delle dashboard LookML, consulta la pagina di documentazione type (per le dashboard LookML).
height
Questa sezione si riferisce al parametro
heightche fa parte di un elemento del dashboard.
heightpuò essere utilizzato anche nell'ambito di una riga del dashboard, come descritto nella pagina della documentazione Parametri del dashboard.
Per le dashboard con layout tile o static
Il parametro height definisce l'altezza di un elemento, in unità di tile_size (definita in pixel), per i dashboard layout: tile e layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e height: 4, rendendo l'elemento orders_by_date alto 400 pixel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
height: 4
...
Per le dashboard con layout newspaper
Il parametro height definisce l'altezza di un elemento, in unità di riga, per i dashboard layout: newspaper.
Un prospetto con layout a giornale ha un'altezza predefinita dell'elemento di 6 righe, ovvero circa 300 pixel. L'altezza minima è di una riga per i dashboard con un parametro preferred viewer impostato su dashboards-next. L'altezza minima è di 2 righe per i dashboard con un parametro preferred viewer impostato su dashboards.
Ad esempio, il seguente codice imposta un elemento in modo che sia alto 12 righe, ovvero il doppio degli altri elementi impostati sul valore predefinito:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
height: 12
...
width
Questa sezione si riferisce al parametro
widthche fa parte di un elemento del dashboard.
widthpuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per i dashboard layout: tile e layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e width: 4, rendendo l'elemento orders_by_date largo 400 pixel.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
width: 4
...
Il parametro width definisce la larghezza di un elemento, in unità di colonne, per i dashboard layout: newspaper.
Una dashboard con layout a giornale ha una larghezza predefinita di 24 colonne.
Ad esempio, il seguente codice imposta l'elemento sulla metà della larghezza del dashboard:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
width: 12
...
top
Il parametro top definisce la posizione dall'alto verso il basso di un elemento, in unità di tile_size, per i dashboard layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e top: 4, posizionando il bordo superiore dell'elemento orders_by_date a 400 pixel dalla parte superiore del dashboard.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
top: 4
...
left
Il parametro left definisce la posizione da sinistra a destra di un elemento, in unità di tile_size, per i dashboard layout: static.
Ad esempio, il seguente codice specifica tile_size: 100 e left: 4, posizionando il bordo sinistro dell'elemento orders_by_date a 400 pixel dal lato sinistro della dashboard.
- dashboard: sales_overview
tile_size: 100
...
elements:
- name: orders_by_date
left: 4
...
row
Per i dashboard layout: newspaper, il parametro row definisce la riga in cui viene posizionato il bordo superiore di un elemento.
Una dashboard inizia con la riga 0 nella parte superiore della dashboard. Una dashboard con layout a giornale ha un'altezza predefinita degli elementi di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0) occuperanno per impostazione predefinita le righe 0-5.
Ogni riga è alta 50 pixel, il che significa che l'altezza predefinita di 6 righe è di 300 pixel.
Ad esempio, il seguente codice imposta un elemento da inserire nella seconda riga di elementi nella dashboard, supponendo che gli elementi siano impostati all'altezza predefinita:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
row: 6
...
col
Per i dashboard layout: newspaper, il parametro col definisce la colonna in cui viene posizionato il bordo sinistro dell'elemento.
Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di giornale ha una larghezza predefinita degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0) occuperanno per impostazione predefinita le colonne 0-7.
Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna degli elementi nel dashboard:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
Questa sezione si riferisce al parametro
refreshche fa parte di un elemento del dashboard.
refreshpuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Il parametro refresh consente a un elemento di ricaricarsi automaticamente a intervalli periodici, recuperando così dati aggiornati. Questo è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio su una TV in ufficio. Tieni presente che il parametro ha effetto solo se la dashboard è aperta in una finestra del browser. Questa impostazione non viene eseguita in background per "preriscaldare" la cache della dashboard.
La frequenza di aggiornamento può essere qualsiasi numero (senza decimali) di secondi, minuti, ore o giorni. Ad esempio:
- name: orders_by_date
refresh: 2 hours
Presta attenzione quando imposti intervalli di aggiornamento brevi. Se la query alla base dell'elemento richiede molte risorse, alcuni elementi potrebbero sovraccaricare il database più del dovuto.
note
Puoi aggiungere note descrittive agli elementi come segue:
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note ha i sottoparametri text, state e display.
text
Il parametro secondario text specifica il testo visualizzato nella nota. Il testo può essere localizzato.
state
Il parametro secondario state determina se la nota sarà collapsed o expanded se è troppo grande per rientrare in una singola riga all'interno della larghezza dell'elemento. Se scegli collapsed e la nota è troppo lunga, terminerà con dei puntini di sospensione (...) su cui è possibile fare clic per leggere la nota completa.
display
Il parametro secondario display determina dove viene visualizzata la nota in un elemento. above posiziona la nota nella parte superiore di un elemento, below la posiziona nella parte inferiore di un elemento e hover richiede all'utente di passare il mouse sopra l'elemento per visualizzare la nota.
Parametri di query
Quando definisci un elemento del dashboard LookML di type: looker_timeline, devi specificare i valori per almeno i parametri di query model e explore. La query deve includere anche i valori per i parametri dimensions e measures, tra cui almeno una dimensione che rappresenti il campo dell'etichetta, ad esempio un nome, nonché un campo iniziale e un campo finale, che possono essere una data o un numero. Per saperne di più sui requisiti minimi per la creazione di grafici a cronologia in Looker, consulta la pagina della documentazione Opzioni del grafico a cronologia.
model
Il parametro model definisce il modello da utilizzare per la query dell'elemento. Se non specificato, il valore predefinito è il modello in cui si trova la dashboard.
- name: orders_by_date
model: ecommerce
Il parametro model accetta costanti LookML. Puoi definire una costante nel file manifest per il tuo progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per model. L'utilizzo di una costante consente di definire il nome di un modello in un unico posto, il che è particolarmente utile se stai aggiornando il nome di un modello utilizzato da più elementi del dashboard.
Per ulteriori informazioni ed esempi sull'utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.
explore
Questa sezione si riferisce al parametro
exploreche fa parte di un elemento del dashboard.
explorepuò essere utilizzato anche nell'ambito di un modello, come descritto nella pagina della documentazione dedicata al parametroexplore.
explorepuò essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
Il parametro explore definisce l'esplorazione da utilizzare per la query dell'elemento.
- name: orders_by_date
explore: order
Il parametro explore accetta costanti LookML. Puoi definire una costante nel file manifest per il tuo progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per explore. L'utilizzo di una costante ti consente di definire il nome di un'esplorazione in un unico posto, il che è particolarmente utile se stai aggiornando il nome di un'esplorazione utilizzata da più elementi del dashboard.
Per ulteriori informazioni ed esempi sull'utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.
dimensions
Il parametro dimensions definisce la dimensione o le dimensioni da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare la dimensione. Non includere dimensions se la query non ne ha.
## single dimension example
- name: orders_by_date
dimensions: order.order_date
## multiple dimension example
- name: orders_by_date
dimensions: [order.order_date, customer.name]
measures
Il parametro measures definisce la misura o le misure da utilizzare per la query sull'elemento. Utilizza la sintassi view_name.measure_name per specificare la misura. Non includere measures se la query non ne ha.
## single measure example
- name: orders_by_date
measures: order.count
## multiple measure example
- name: orders_by_date
measures: [order.count, order_item.count]
sorts
Il parametro sorts definisce gli ordinamenti da utilizzare per la query dell'elemento. L'ordinamento principale è elencato per primo, seguito dall'ordinamento secondario e così via. Utilizza la sintassi view_name.field_name per specificare la dimensione o la misura. Non includere sorts se vuoi utilizzare l'ordinamento predefinito di Looker. Gli ordinamenti decrescenti hanno il suffisso desc, mentre quelli crescenti non ne hanno bisogno.
## single sort example
- name: orders_by_date
sorts: order.order_date desc
## multiple sort example
- name: orders_by_date
sorts: [order.order_date desc, customer.name]
pivots
Il parametro pivots definisce le dimensioni da pivotare per la query sugli elementi. Utilizza la sintassi view_name.dimension_name per specificare la dimensione. Non includere pivots se la query non ne ha.
## single pivot example
- name: orders_by_date
pivots: customer.gender
## multiple pivot example
- name: orders_by_date
pivots: [customer.gender, customer.age_tier]
limit
Il parametro limit definisce il limite di righe da utilizzare per la query dell'elemento. Il limite si applica al numero di righe prima dell'applicazione di eventuali tabelle pivot.
- name: orders_by_date
limit: 100
filters
Questa sezione si riferisce al parametro
filtersche fa parte di un elemento del dashboard.
filterspuò essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.
filterspuò essere utilizzato anche nell'ambito di una misura, come descritto nella pagina della documentazione dedicata al parametrofilters.
Il parametro filters definisce i filtri non modificabili da utilizzare per la query dell'elemento. Se vuoi che un utente possa modificare i filtri nella dashboard, devi configurarli utilizzando filters per le dashboard, quindi applicarli agli elementi utilizzando listen.
La sintassi per filters è:
- name: element_name
filters:
orders.created_date: 2020/01/10 for 3 days
orders.status: Shipped
# You can create multiple filter statements
Ogni filtro può accettare un'espressione di filtro di Looker o una costante di valore. Puoi anche utilizzare le variabili Liquid _localization o _user_attributes nell'espressione di filtro per valori di filtro flessibili.
listen
I filtri della dashboard consentono ai visualizzatori di perfezionare in modo interattivo i dati visualizzati negli elementi della dashboard. Definisci i filtri della dashboard con il parametro filters per le dashboard LookML. Poi utilizza il parametro listen per collegare gli elementi del dashboard al filtro del dashboard.
La sintassi per listen è la seguente:
- name: element_name
listen:
filter_name_goes_here: dimension or measure on which to apply
the filter using view_name.field_name syntax
# You can add more than one listen statement
Aggiungi il parametro listen a un elemento, quindi fornisci il nome del filtro seguito da due punti e da un riferimento al campo a cui deve essere applicato il filtro, utilizzando la sintassi view_name.field_name. Ad esempio, potresti creare un filtro chiamato Data che richiede a un utente di inserire una data nel campo del filtro nell'interfaccia utente. Puoi quindi applicare il valore inserito dall'utente all'elemento orders_by_date nel seguente modo:
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
Per altri esempi di utilizzo dei parametri filters e listen per applicare filtri della dashboard a singoli elementi della dashboard, consulta Creazione di dashboard LookML.
query_timezone
Il parametro query_timezone specifica il fuso orario in cui verrà eseguita la query. Le opzioni del fuso orario sono mostrate nella pagina di documentazione Valori per timezone. Se vuoi che la query venga eseguita utilizzando il fuso orario del visualizzatore, puoi assegnare il valore user_timezone.
- name: orders_by_date
query_timezone: America/Los Angeles
- name: orders_by_customer
query_timezone: user_timezone
merged_queries
Il parametro merged_queries ti consente di combinare i risultati di più query in un unico elemento della dashboard. Definisci ogni query di origine all'interno del parametro merged_queries dell'elemento e utilizza il parametro secondario join_fields per specificare come devono essere uniti i risultati.
Il seguente codice LookML di esempio crea un elemento di type: looker_grid dei risultati uniti. In questo esempio, il parametro merged_queries viene utilizzato per creare un elemento del dashboard che combina i dati di due query separate in un unico grafico a tabella:
- name: merged_results_element
title: Merged Results Tile
type: looker_grid
merged_queries:
- model: ecommerce
explore: users
type: table
fields: [users.state, users.count, users.city]
sorts: [users.count desc 0]
limit: 5000
column_limit: 50
query_timezone: UTC
listen:
- State: users.state
- model: ecommerce
explore: users
type: table
fields: [users.state, users.city]
sorts: [users.state]
limit: 500
column_limit: 50
query_timezone: UTC
join_fields:
- field_name: users.state
source_field_name: users.state
- field_name: users.city
source_field_name: users.city
listen:
- State: users.state
In questo esempio, l'elemento del dashboard combina i dati di due query di origine basate sull'esplorazione users nel modello ecommerce. La query principale include i campi users.state, users.count e users.city e ordina i risultati in base al campo users.count. La seconda query di origine include i campi users.state e users.city e ordina i risultati in base al campo users.state.
Il parametro join_field unisce le query di origine in base ai valori corrispondenti nei campi users.state e users.city.
Il parametro listen applica un filtro State a entrambe le query, consentendo agli utenti che visualizzano la dashboard di perfezionare i risultati della query visualizzati nel riquadro della dashboard selezionando uno stato specifico.
Esempio: unione dei dati aziendali
Supponiamo che tu voglia creare una query unita che combini le informazioni sulle aziende di due esplorazioni diverse: company_info e companies. Vuoi unire le query nei campi ipo.stock_symbol, companies.name e companies.contact_email di ogni esplorazione per creare una query che restituisca risultati per nome dell'azienda, email di contatto dell'azienda, anno dell'IPO, simbolo azionario, numero di dipendenti e numero di offerte di lavoro. Puoi definire l'elemento della query unita in LookML nel seguente modo:
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
filters:
companies.contact_email: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: company_data
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.contact_email,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.contact_email: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: companies.name
- field_name: companies.contact_email
source_field_name: companies.contact_email
Applicare filtri agli elementi della query uniti
L'esempio precedente di un elemento di query unito mostra come applicare filtri hardcoded direttamente all'interno di ogni query di origine utilizzando il parametro filters. Ad esempio, i filtri companies.contact_email: "-NULL" e ipo.valuation_amount: NOT NULL nella query principale limitano i risultati alle aziende che hanno valutazioni ed email di contatto valide. Questi filtri a livello di query prefiltrano i dati prima di unire le query e non possono essere modificati dall'utente.
Puoi anche applicare filtri del dashboard agli elementi della query uniti utilizzando il parametro listen nella definizione di ogni query di origine. Ad esempio, supponiamo di avere un filtro della dashboard denominato Industry che hai definito a livello di dashboard utilizzando il parametro filters per le dashboard LookML:
filters:
- name: Industry
title: Industry
type: field_filter
ui_config:
type: dropdown_menu
display: inline
model: market_research
explore: company_info
field: companies.industry
Per applicare il filtro Industry al campo companies.industry in entrambe le query di origine, aggiungi il parametro listen a ciascuna delle definizioni delle query di origine della query unita nel seguente modo:
listen:
Industry: companies.industry
Ad esempio, il seguente codice campione aggiunge il filtro Industry a entrambe le query di origine nell'elemento dei risultati uniti dell'esempio precedente.
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
filters:
companies.contact_email: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
listen:
Industry: companies.industry
- model: company_data
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.contact_email,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.contact_email: "-NULL"
sorts: [jobs.job_count desc]
join_fields:
- field_name: ipo.stock_symbol
source_field_name: ipo.stock_symbol
- field_name: companies.name
source_field_name: companies.name
- field_name: companies.contact_email
source_field_name: companies.contact_email
listen:
Industry: companies.industry
Con questa aggiunta, quando un utente interagisce con il filtro della dashboard Industry, la query di origine corrispondente nell'elemento della query unita verrà filtrata di conseguenza.
hidden_fields
Il parametro hidden_fields indica quali campi, se presenti, vengono utilizzati nella query ma sono nascosti nel grafico. Tutti i campi nascosti vengono visualizzati nella sezione della tabella dati di un'esplorazione.
hidden_fields: [inventory_items.count, distribution_centers.id]
Parametri delle opzioni
La maggior parte dei parametri descritti in questa sezione corrisponde alle opzioni della sezione Opzioni dell'editor di visualizzazione per i grafici a cronologia.
color_application
Il parametro color_application e i relativi parametri secondari collection_id e palette_id possono essere utilizzati per applicare una raccolta e una tavolozza di colori specifiche a un elemento del dashboard. Per una panoramica delle raccolte di colori native di Looker, consulta la pagina della documentazione Raccolte di colori.
Se hai l'ID raccolta e l'ID tavolozza per la tavolozza che vuoi utilizzare, puoi inserirli nei sottoparametri collection_id e palette_id. Un ID raccolta o un ID tavolozza può essere un codice alfanumerico o basato sul nome della raccolta di colori. Per le raccolte native di Looker vengono utilizzati codici alfanumerici. Sono specifici dell'istanza e hanno questo aspetto:
color_application:
collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1
Le raccolte di colori personalizzate utilizzano ID raccolta e tavolozza basati sul nome della raccolta di colori, che sono portabili tra le istanze e hanno questo aspetto:
color_application:
collection_id: blue-tone-collection
palette_id: blue-tone-collection-categorical-0
Puoi anche utilizzare la UI per trovare i colori, le raccolte o le tavolozze che preferisci e generare il codice LookML per aggiungerli alla dashboard. Vai a un contenuto definito dall'utente (ad esempio un look, una dashboard o un'esplorazione) e applica i colori, la raccolta o la tavolozza che preferisci alla visualizzazione dei contenuti utilizzando la UI. Una volta fatto, puoi seguire i passaggi per ottenere il LookML della dashboard, copiare il LookML prodotto e incollarlo nella sezione color_application.
groupBars
Determina se la visualizzazione deve mostrare ogni barra dei record nella propria riga o se le barre dei record per ogni valore dell'etichetta devono trovarsi tutte nella stessa riga. Se imposti groupBars su true, tutti i record che condividono lo stesso valore di etichetta vengono visualizzati come barre individuali nella stessa riga della visualizzazione.
groupBars: true | false
labelSize
Specifica una dimensione del carattere per le etichette. Ad esempio:
labelSize: 12pt
valueFormat
Specifica il formato numerico o il formato data per il valore. Il parametro accetta la formattazione in stile Excel. Se non viene specificata alcuna formattazione, il valore verrà visualizzato nel formato della dimensione o della metrica sottostante.
showLegend
Mostra o nascondi una legenda nella parte inferiore della visualizzazione.
showLegend: true | false