Questa pagina mostra come aggiungere e personalizzare un elemento della dashboard LookML di type: table
con i parametri della dashboard di LookML in un file dashboard.lkml
.
Per informazioni sulla creazione di un grafico (legacy) tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Opzioni del grafico (legacy) con le tabelle.
Esempio di utilizzo
## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_table
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
## QUERY PARAMETERS
model: model_name
explore: explore_name
dimensions: [view_name.field_name, view_name.field_name, …]
measures: [view_name.field_name, view_name.field_name, …]
sorts: [view_name.field_name asc | desc, view_name.field_name, …]
pivots: [view_name.field_name, view_name.field_name, …]
limit: N
column_limit: N
filters:
view_name.field_name: 'Looker filter expression' | 'filter value'
listen:
dashboard_filter_name: dimension_or_measure_name
query_timezone: 'specific timezone' | user_timezone
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
total: true | false
row_total: right | left | false
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
hidden_fields: [view_name.field_name, view_name.field_name, …]
limit_displayed_rows: true | false
limit_displayed_rows_values:
show_hide: show | hide
first_last: first | last
num_rows: 'N'
## SERIES PARAMETERS
truncate_column_names: true | false
show_view_names: true | false
series_labels:
view_name.field_name: desired series label
## FORMATTING PARAMETERS
enable_conditional_formatting: true | false
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls: true | false
conditional_formatting:
{'desired conditional formatting'}
Definizioni dei parametri
Nome parametro | Descrizione | |
---|---|---|
Parametri di base | ||
name (per gli elementi) |
Crea un elemento | |
title (per gli elementi) |
Cambia la modalità di visualizzazione del nome di un elemento per gli utenti | |
type (per gli elementi) |
Determina il tipo di visualizzazione da utilizzare nell'elemento | |
height (per gli elementi) |
Definisce l'altezza di un elemento in unità di tile_size per le dashboard di layout: tile e layout: static |
|
width (per gli elementi) |
Definisce la larghezza di un elemento in unità di tile_size per le dashboard di layout: tile e layout: static |
|
top |
Definisce la posizione dall'alto verso il basso di un elemento in unità di tile_size per le dashboard di layout: static |
|
left |
Definisce la posizione da sinistra a destra di un elemento nelle unità di tile_size per le dashboard di layout: static |
|
row |
Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per le dashboard di layout: newspaper |
|
col |
Definisce la posizione da sinistra a destra di un elemento in unità di colonne per le dashboard di layout: newspaper |
|
refresh (per gli elementi) |
Imposta l'intervallo a cui l'elemento si aggiorna automaticamente | |
note |
Avvia una sezione di LookML per definire una nota per un elemento. Questo parametro ha i sottoparametri text , state e display . |
|
Parametri di query | ||
model |
Definisce il modello da utilizzare per la query dell'elemento | |
explore (per gli elementi) |
Definisce l'esplorazione da utilizzare per la query dell'elemento | |
dimensions |
Definisce le dimensioni da utilizzare per la query dell'elemento | |
measures |
Definisce le misure da utilizzare per la query dell'elemento | |
sorts |
Definisce gli ordinamenti da utilizzare per la query dell'elemento | |
pivots |
Definisce le dimensioni che devono essere utilizzate per la query dell'elemento | |
limit |
Definisce il limite di righe da utilizzare per la query dell'elemento | |
filters (per gli elementi) |
Definisce i filtri che non possono essere modificati per la query dell'elemento. | |
listen |
Definisce i filtri che possono essere modificati per la query dell'elemento, se sono stati creati filters (per la dashboard) |
|
query_timezone |
Definisce il fuso orario da utilizzare quando viene eseguita la query | |
merged_queries |
Definisce una query di risultati uniti | |
Parametri di trama | ||
table_theme |
Applica una delle cinque opzioni per la colorazione delle tabelle a una visualizzazione tabella | |
total |
Specifica se i totali delle colonne vengono visualizzati per una visualizzazione tabella | |
row_total |
Specifica se i totali delle righe vengono visualizzati per una visualizzazione tabella | |
show_row_numbers |
Consente di stabilire se mostrare un numero di riga all'inizio di ogni riga della tabella. | |
hide_totals |
Imposta se una visualizzazione tabella mostra i totali delle colonne | |
hide_row_totals |
Imposta se una visualizzazione tabella mostra i totali delle righe | |
hidden_fields |
Specifica i campi da utilizzare nella query ma nascondi nel grafico | |
limit_displayed_rows |
Mostra o nasconde le righe di una visualizzazione in base alla loro posizione nei risultati. | |
limit_displayed_rows_values |
Specifica quali righe mostrare o nascondere in una visualizzazione. Questo parametro ha i sottoparametri show_hide , first_last e num_rows . |
|
Parametri serie | ||
truncate_column_names |
Abbrevia le intestazioni di colonna con i puntini di sospensione (...) | |
show_view_names |
Mostra il nome della visualizzazione insieme al nome del campo per ogni intestazione di colonna. | |
series_labels |
Specifica un'etichetta personalizzata per ogni colonna nella visualizzazione. | |
Parametri di formattazione | ||
enable_conditional_formatting |
Imposta su true per definire le regole di codifica dei colori per una visualizzazione tabella |
|
conditional_formatting_include_totals |
Specifica se i totali sono inclusi nello schema di codifica dei colori | |
conditional_formatting_include_nulls |
Specifica se i valori null devono essere rappresentati come zero | |
conditional_formatting |
Utilizza conditional_formatting e i relativi sottoparametri per definire le regole che colorano il codice della visualizzazione tabella |
Parametri di base
Quando si definisce un elemento della dashboard di LookML, è necessario specificare dei valori per almeno i parametri name
e type
. Altri parametri di base come title
, height
e width
influiscono sulla posizione e sull'aspetto di un elemento su una dashboard.
name
Questa sezione si riferisce al parametro
name
che fa parte di un elemento della dashboard.
name
può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione Parametri della dashboard.
Ogni dichiarazione name
crea un nuovo elemento della dashboard a cui assegna un nome. I nomi degli elementi devono essere univoci. A volte viene fatto riferimento ai nomi nel parametro elements
quando utilizzi le dashboard di layout: grid
.
- name: orders_by_date
title
Questa sezione si riferisce al parametro
title
che fa parte di un elemento della dashboard.
title
può essere utilizzato anche come parte di una dashboard, descritto nella pagina della documentazione relativa ai parametri della dashboard.
title
può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione Parametri della dashboard.
Il parametro title
consente di cambiare il modo in cui il nome di un elemento viene visualizzato dagli utenti. Se non è specificato alcun titolo, il titolo viene impostato automaticamente sull'elemento name
.
Considera questo esempio:
- name: sales_overview
title: '1) Sales Overview'
Se hai utilizzato questo formato, invece dell'elemento visualizzato Panoramica delle vendite, viene visualizzato come 1) Panoramica delle vendite.
type
Questa sezione si riferisce al parametro
type
che fa parte di un elemento della dashboard.
type
può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione Parametri della dashboard.
type
può essere utilizzato anche come parte di un join, descritto nella pagina della documentazione relativa al parametrotype
(per join).
type
può essere utilizzato anche come parte di una dimensione, descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.
type
può essere utilizzato anche come parte di una misura, descritto nella pagina della documentazione Tipi di misurazioni.
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
Consulta la pagina della documentazione type
(per le dashboard di LookML) per una panoramica dei diversi tipi di elementi delle dashboard di LookML.
height
Questa sezione si riferisce al parametro
height
che fa parte di un elemento della dashboard.
height
può essere utilizzato anche come parte di una riga della dashboard, descritto nella pagina della documentazione Parametri della 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 le 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 le dashboard di layout: newspaper
.
Per impostazione predefinita, una dashboard con layout del giornale ha un'altezza dell'elemento di 6 righe o circa 300 pixel. L'altezza minima è di 1 riga per le dashboard con un parametro preferred viewer
impostato su dashboards-next
. L'altezza minima è di 2 righe per le dashboard con un parametro preferred viewer
impostato su dashboards
.
Ad esempio, il seguente codice imposta un elemento alto 12 righe o doppio rispetto agli 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
width
che fa parte di un elemento della dashboard.
width
può essere utilizzato anche come parte di una dashboard, descritto nella pagina della documentazione relativa ai parametri della dashboard.
Il parametro width
definisce la larghezza di un elemento, in unità di tile_size
, per le dashboard di layout: tile
e layout: static
.
Ad esempio, il seguente codice specifica tile_size: 100
e width: 4
, per cui l'elemento orders_by_date
ha una larghezza di 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 le dashboard di layout: newspaper
.
Per impostazione predefinita, una dashboard con layout del giornale ha una larghezza di 24 colonne.
Ad esempio, il seguente codice imposta l'elemento su metà larghezza della 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 le dashboard di layout: static
.
Ad esempio, il codice seguente specifica tile_size: 100
e top: 4
, posizionando il bordo superiore dell'elemento orders_by_date
a 400 pixel dalla parte superiore della 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 le dashboard di 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 le dashboard di layout: newspaper
, il parametro row
definisce la riga in cui si trova il bordo superiore di un elemento.
La dashboard inizia con la riga 0 nella parte superiore della dashboard. Per impostazione predefinita, una dashboard con layout del giornale ha un'altezza dell'elemento di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0
) occupano le righe 0-5.
Ogni riga ha un'altezza di 50 pixel, il che significa che l'altezza predefinita dell'elemento di 6 righe è 300 pixel.
Ad esempio, il seguente codice imposta un elemento da impostare 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 le dashboard di layout: newspaper
, il parametro col
definisce la colonna su cui viene posizionato il bordo sinistro dell'elemento.
Le dashboard sono divise in 24 colonne. La dashboard inizia con la colonna 0, a sinistra della dashboard. Per impostazione predefinita, una dashboard con layout del giornale ha una larghezza degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0
) occupano le colonne da 0 a 7 per impostazione predefinita.
Ad esempio, il seguente codice imposta un elemento da impostare nella terza colonna di elementi della dashboard:
- dashboard: sales_overview
layout: newspaper
...
elements:
- name: orders_by_date
col: 16
...
refresh
Questa sezione si riferisce al parametro
refresh
che fa parte di un elemento della dashboard.
refresh
può essere utilizzato anche come parte di una dashboard, descritto nella pagina della documentazione relativa ai parametri della dashboard.
Il parametro refresh
consente a un elemento di ricaricarsi automaticamente su base periodica, recuperando così i dati aggiornati. Spesso è utile nelle impostazioni in cui viene sempre visualizzata una dashboard, ad esempio sulla TV di un ufficio. Tieni presente che per ottenere questo effetto, la dashboard deve essere aperta in una finestra del browser. Questa impostazione non viene eseguita in background per "preparare" 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
Fai attenzione quando imposti intervalli di aggiornamento brevi. Se la query alla base dell'elemento richiede molte risorse, alcuni elementi potrebbero sovraccaricare il database più di quanto ti serva.
note
Puoi aggiungere note descrittive a elementi come questi:
- name: element_name
note:
text: 'note text'
state: collapsed | expanded
display: above | below | hover
note
ha i sottoparametri text
, state
e display
.
text
Il sottoparametro text
specifica il testo visualizzato nella nota. Il testo può essere localizzato.
state
Il sottoparametro state
determina se la nota sarà di collapsed
o expanded
se è troppo grande per rientrare in una singola riga della larghezza dell'elemento. Se scegli collapsed
e la nota è troppo lunga, terminerà con un'ellissi cliccabile (...
) che può essere utilizzata per leggere la nota completa.
display
Il sottoparametro display
determina dove viene visualizzata la nota su un elemento. above
posiziona la nota nella parte superiore di un elemento, below
la posiziona nella parte inferiore dell'elemento e hover
richiede che l'utente passi il mouse sopra l'elemento per visualizzarla.
Parametri di ricerca
Quando definisci un elemento della dashboard di LookML, devi specificare dei valori per almeno i parametri di ricerca model
e explore
, mentre devi specificare almeno un campo con il parametro dimensions
o measures
. Puoi anche utilizzare gli altri parametri di ricerca descritti di seguito per controllare la modalità di visualizzazione dei dati in un elemento della dashboard.
model
Il parametro model
definisce il modello da utilizzare per la query dell'elemento. Se non è specificato, verrà utilizzato il modello predefinito in cui si trova la dashboard.
- name: orders_by_date
model: ecommerce
Il parametro model
accetta le costanti LookML. Puoi definire una costante nel file manifest per il tuo progetto, quindi utilizzare la sintassi "@{constant_name}"
per impostarla come valore di model
. L'utilizzo di una costante consente di definire il nome di un modello in un'unica posizione, il che è particolarmente utile se stai aggiornando il nome di un modello utilizzato da più elementi della dashboard.
Per saperne di più e per un esempio di utilizzo delle costanti con le dashboard di LookML, consulta la pagina della documentazione del parametro constant
.
explore
Questa sezione si riferisce al parametro
explore
che fa parte di un elemento della dashboard.
explore
può essere utilizzato anche come parte di un modello, descritto nella pagina della documentazione del parametroexplore
.
explore
può essere utilizzato anche come parte di un filtro della dashboard, 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 le costanti LookML. Puoi definire una costante nel file manifest per il tuo progetto, quindi utilizzare la sintassi "@{constant_name}"
per impostarla come valore di explore
. L'utilizzo di una costante consente di definire il nome di un'esplorazione in una sola posizione, il che è particolarmente utile se stai aggiornando il nome di un'esplorazione utilizzata da più elementi della dashboard.
Per saperne di più e per un esempio di utilizzo delle costanti con le dashboard di 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 contiene nessuno.
## 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 dell'elemento. Utilizza la sintassi view_name.measure_name
per specificare la misura. Non includere measures
se la query non ne contiene nessuno.
## 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 viene elencato per primo, seguito dall'ordinamento secondario e così via. Utilizza la sintassi view_name.field_name
per specificare la dimensione o la misurazione. Non includere sorts
se vuoi usare l'ordinamento predefinito di Looker. Gli ordinamento crescente hanno un suffisso desc
; non è necessario un suffisso per gli ordinamento crescente.
## 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 che devono essere pivot per la query dell'elemento. Utilizza la sintassi view_name.dimension_name
per specificare la dimensione. Non includere pivots
se la query non ne contiene nessuno.
## 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 all'elemento. Il limite si applica al numero di righe prima di applicare eventuali pivot.
- name: orders_by_date
limit: 100
filters
Questa sezione si riferisce al parametro
filters
che fa parte di un elemento della dashboard.
filters
può essere utilizzato anche come parte di una dashboard, descritto nella pagina della documentazione relativa ai parametri della dashboard.
filters
può essere utilizzato anche come parte di una misura, descritto nella pagina della documentazione del parametrofilters
.
Il parametro filters
definisce i filtri non modificabili da utilizzare per la query dell'elemento. Se vuoi che i filtri possono essere modificati nella dashboard, devi impostarli utilizzando filters
per le dashboard e poi applicarli agli elementi utilizzando listen
.
La sintassi di filters
è la seguente:
- 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 o una costante di valore di Looker. Per i valori dei filtri flessibili, puoi anche utilizzare le variabili Liquid _localization
o _user_attributes
nell'espressione di filtro.
listen
Le dashboard possono avere filtri che consentono agli utenti di modificare i dati dietro gli elementi della dashboard. Per configurare queste impostazioni, utilizza il parametro filters
per le dashboard. Affinché un filtro influisca su un elemento, deve essere impostato su "ascolta" per tale filtro utilizzando il parametro listen
.
La sintassi di 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
Ad esempio, potresti creare un filtro chiamato Data che richiede all'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
in questo modo:
- dashboard: sales_overview
...
filters:
- name: date
type: date_filter
elements:
- name: orders_by_date
listen:
date: order.order_date
...
Questo concetto è descritto più dettagliatamente nella pagina della documentazione Creazione di dashboard LookML.
query_timezone
Il parametro query_timezone
specifica il fuso orario in cui verrà eseguita la query. Le opzioni relative al fuso orario sono visualizzate nella pagina della 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
definisce la modalità di unione dei risultati di diverse query. Puoi definire le query sui componenti nel parametro merged_queries
e utilizzare il sottoparametro join_fields
per definire le regole di unione.
La sintassi di merged_queries
è la seguente:
merged_queries:
- 'primary query definition'
- 'next source query definition'
join_fields:
- field_name: 'field from the source query using the view_name.field_name syntax'
source_field_name: 'joined field from the primary query using the
view_name.field_name syntax'
# more join_fields definitions as needed
- 'next source query definition'
join_fields:
- field_name: view_name.field_name
source_field_name: view_name.field_name
# more join_fields definitions as needed
# additional source queries and join_fields definitions as needed
La prima query definita in merged_results
è la query principale e le altre query verranno unite con quella.
Ad esempio, unendoti al simbolo di borsa, al nome dell'azienda e al nome utente di Twitter, potrai unire due query per ottenere risultati relativi a nome dell'azienda, nome utente Twitter dell'azienda, anno IPO, simbolo di borsa, numero di dipendenti e conteggio del lavoro:
- name: merged_results_element
title: Merged Results Tile
merged_queries:
- model: market_research
explore: company_info
fields: [company.name, company.twitter_username, ipo.public_year, ipo.stock_symbol]
filters:
company.twitter_username: "-NULL"
ipo.valuation_amount: NOT NULL
sorts: [ipo.public_year desc]
- model: crunchbase
explore: companies
fields: [companies.name, ipo.stock_symbol, companies.twitter_username,
companies.number_of_employees, jobs.job_count]
filters:
companies.number_of_employees: NOT NULL
ipo.stock_symbol: "-NULL"
companies.twitter_username: "-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: company.name
- field_name: companies.twitter_username
source_field_name: company.twitter_username
I risultati dei dati verrebbero formattati come segue:
Successivamente, puoi applicare i parametri dell'elemento per personalizzare la visualizzazione in base alle tue esigenze.
Traccia grafici
I seguenti parametri corrispondono alle opzioni nella sezione Grafico dell'editor di visualizzazione per i grafici a tabella (legacy).
table_theme
Utilizza il parametro table_theme
per applicare una delle seguenti opzioni di colorazione delle tabelle a un elemento della tabella:
editable
: la tabella ha dimensioni blu, misure arancioni e calcoli verdi della tabella.white
: l'intestazione della tabella è bianca, le righe dei dati si alternano tra bianco e grigio e il testo è nero.gray
: l'intestazione della tabella è grigia, le righe dei dati si alternano tra bianco e grigio chiaro e il testo è grigio scuro.transparent
: l'intestazione della tabella è completamente trasparente, le righe dei dati si alternano in modo totalmente trasparente e in grigio traslucido e il colore del testo si regola dal nero al bianco in base al colore di sfondo mostrato. L'impostazione ditable_theme
sutransparent
può essere utile quando utilizzi una dashboard incorporata personalizzata in modo che il colore di sfondo del riquadro venga mostrato attraverso la visualizzazione.unstyled
: le righe di dati e intestazione della tabella sono bianche e il testo è nero.
table_theme: editable | white | gray | transparent | unstyled
total
Il parametro total
consente di impostare se una riga dei totali viene mostrata in fondo alla tabella. Per ulteriori informazioni, consulta la sezione Visualizzare i totali.
total: true | false
## default value: false
row_total
Il parametro row_total
imposta se mostrare una colonna dei totali a destra o a sinistra della tabella. Funziona solo se è presente un pivot. Per ulteriori informazioni, consulta la sezione Visualizzazione dei totali.
row_total: right | left | false
## default value: false
show_row_numbers
Il parametro show_row_numbers
consente di impostare se un numero di riga verrà visualizzato all'inizio di ogni riga della tabella.
show_row_numbers: true | false
hide_totals
Se la funzionalità Esplora include i totali della colonna, hide_totals
imposta se la visualizzazione mostra i totali.
hide_totals: true | false
hide_row_totals
Se la sezione Esplora include i totali delle righe, hide_row_totals
imposta se i totali delle righe verranno visualizzati nella visualizzazione.
hide_row_totals: true | false
hidden_fields
Il parametro hidden_fields
indica gli eventuali campi utilizzati nella query, ma nascosti nel grafico. Eventuali campi nascosti verranno visualizzati nella sezione della tabella dati di un'esplorazione.
hidden_fields: [inventory_items.count, distribution_centers.id]
limit_displayed_rows
Il parametro limit_displayed_rows
consente di mostrare o nascondere le righe di una visualizzazione, in base alla loro posizione nei risultati. Ad esempio, se la visualizzazione mostra una media mobile di 7 giorni, puoi nascondere le prime 6 righe. Se imposti questa opzione su true
, puoi specificare i valori e le posizioni nella visualizzazione a cui si applica utilizzando il parametro limit_displays_rows_values
e i relativi sottoparametri.
limit_displayed_rows: true
limit_displayed_rows_values:
show_hide: hide | show
first_last: first | last
num_rows: '10'
limit_displayed_rows_values
Utilizza il parametro limit_displayed_rows_values
e i relativi sottoparametri show_hide
, first_last
e num_rows
, con limit_displayed_rows
per specificare le righe da mostrare o nascondere in una visualizzazione. Vedi limit_displayed_rows
sopra per un esempio di utilizzo.
show_hide
Il sottoparametro show_hide
imposta se nascondere determinate righe nella visualizzazione. Imposta show_hide
su show
per visualizzare solo un numero limitato di righe nella visualizzazione e show_hide
su hide
per escludere determinate righe dalla visualizzazione.
first_last
Il sottoparametro first_last
imposta se le righe da nascondere o mostrare saranno le prime o le ultime righe del set di risultati. Se imposti first_last
su first
, le prime righe vengono visualizzate o nascoste, mentre first_last
su last
mostra o nasconde le ultime righe.
num_rows
Il sottoparametro num_rows
imposta il numero di righe da nascondere o mostrare. Ad esempio, num_rows: '10'
mostra o nasconde la prima o le ultime 10 righe del set di risultati dalla visualizzazione.
Parametri serie
I seguenti parametri corrispondono alle opzioni nella sezione Serie dell'editor di visualizzazione per i grafici a tabella (legacy).
truncate_column_names
Il parametro truncate_column_names
consente di ridurre o meno l'intestazione delle colonne con i puntini di sospensione (...).
truncate_column_names: true | false
show_view_names
Il parametro show_view_names
determina se i nomi delle viste vengono visualizzati nelle etichette dei grafici, come i nomi degli assi e i nomi delle colonne.
show_view_names: true | false
## default value: true
series_labels
Imposta le etichette di una o più serie in base al nome della serie, utilizzando name: label
coppie.
Per un grafico pivot, i nomi delle serie sono i nomi pivot.
series_labels:
'Yes': iOS Users
'No': Android Users
Per un grafico con più misurazioni, i nomi delle serie sono i nomi dei campi di misurazione.
series_labels:
inventory_items.count: Inventory
orders.count: Orders
Parametri di formattazione
I seguenti parametri corrispondono alle opzioni nella sezione Formattazione dell'editor di visualizzazione per i grafici a tabella (legacy).
enable_conditional_formatting
L'impostazione di enable_conditional_formatting
su true
consente di definire regole che codificano il colore della visualizzazione tabella in base a una scala o specificando i valori di interesse.
enable_conditional_formatting: true | false
conditional_formatting_include_totals
Se il criterio enable_conditional_formatting
è impostato su true
, conditional_formatting_include_totals
specifica se i totali sono inclusi nello schema di codifica dei colori.
conditional_formatting_include_totals: true | false
conditional_formatting_include_nulls
Se enable_conditional_formatting
è impostato su true
, conditional_formatting_include_nulls
specifica se i valori null devono essere rappresentati come zeri.
conditional_formatting_include_nulls: true | false
conditional_formatting
Con enable_conditional_formatting
impostato su true
, utilizza il parametro conditional_formatting
per definire le regole che codificano il colore nella visualizzazione della tabella. Per ogni regola di formattazione condizionale, puoi specificare le impostazioni con i seguenti parametri:
Di seguito è riportato un esempio di regola di formattazione condizionale:
conditional_formatting: [{type: less than, value: 20, background_color: "#9fdee0",
font_color: "#b15928", bold: true, italic: false, strikethrough: false,
fields: [order_items.count], color_application: {collection_id: my-custom-colors,
palette_id: my-custom-colors-sequential-0}}]
type
Il parametro type
specifica se colorare i valori del codice su una scala o in base a una condizione logica.
Se utilizzi valori di codifica a colori su una scala, puoi impostare type
su along a scale...
.
Se scegli valori di codifica a colori in base a una condizione logica, puoi specificare uno dei seguenti valori per type
, insieme a un valore per value
:
equal to
: la regola si applica ai valori uguali al numero specificato pervalue
.not equal to
: la regola si applica ai valori che non corrispondono al numero specificato pervalue
greater than
: la regola si applica ai valori che superano il numero specificato pervalue
.less than
: la regola si applica ai valori inferiori al numero specificato pervalue
.between
: la regola si applica ai valori compresi tra due numeri specificati pervalue
.not between
: la regola si applica ai valori che non sono compresi tra i due numeri specificati pervalue
.'null'
: la regola si applica solo ai valori nulli.not null
: la regola si applica solo ai valori che non sono nulli.
type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null
value
Se scegli valori di codifica a colori basati su una condizione logica diversa da 'null'
o not null
, specifica il valore a cui si applica la regola. Il parametro value
accetta un singolo numero o, quando type
è impostato su between
o not between
, un insieme di due numeri.
value: N | [N, N]
background_color
Se la codifica dei colori si basa su una condizione logica (type
è impostato su un valore diverso da along a scale...
), utilizza il parametro background_color
per specificare un colore di sfondo per i valori a cui si applica la regola.
background_color: "#49cec1"
font_color
Se la codifica dei colori si basa su una condizione logica (type
è impostato su un valore diverso da along a scale...
), utilizza il parametro font_color
per specificare un colore di carattere per i valori a cui si applica la regola.
font_color: "#1f3e5a"
color_application
Il parametro color_application
e i relativi sottoparametri collection_id
, palette_id
e options
possono essere utilizzati per applicare una raccolta di colori e una tavolozza specifici a una regola di formattazione condizionale.
Puoi aggiungere colori a una dashboard di LookML per ID raccolta e ID tavolozza, se disponibili. Puoi anche utilizzare l'interfaccia utente per trovare i colori che preferisci e generare il codice LookML per aggiungerli alla dashboard. Accedi a un contenuto definito dall'utente (come Look, dashboard o Esplora) e applica i colori che preferisci alla visualizzazione del contenuto mediante l'interfaccia utente. Al termine, puoi seguire i passaggi per recuperare il LookML della dashboard, copiare il LookML prodotto e incollarlo nella sezione color_application
. Per una panoramica delle raccolte di colori predefinite di Looker, consulta la pagina della documentazione relativa alle raccolte di colori.
Il sottoparametro options
può essere utilizzato se hai impostato type
su along a scale...
. Ha i seguenti parametri secondari:
steps
: questo parametro limita il numero di colori utilizzati al valore specificato e separa i dati in quel numero di gruppi. Se questo parametro non viene utilizzato, i dati vengono colorati in base a una sfumatura che copre l'intera tavolozza. Accetta valori compresi tra2
e100
.mirror
: se è impostato sutrue
, questo parametro applica variazioni di colore uguali su entrambi i lati della tavolozza dei colori per valori uguali su entrambi i lati di un punto centrale definito. Accettatrue
ofalse
.constraints
: questo parametro imposta l'intervallo di dati a cui si applica la formattazione condizionale e imposta un punto centrale da utilizzare per l'applicazione della tavolozza. Accetta la seguente sintassi:constraints: {min: {type: number, value: 3}, max: {type: percentile, value: 99}, mid: {type: average}}
reverse
: questo parametro determina se invertire la tavolozza dei colori durante l'applicazione dei colori. Accettatrue
ofalse
.
bold
Quando la codifica dei colori è basata su una condizione logica, imposta se applicare il grassetto ai valori a cui si applica la regola.
bold: true | false
italic
Quando la codifica dei colori è basata su una condizione logica, imposta se applicare il corsivo ai valori a cui si applica la regola.
italic: true | false
strikethrough
Quando la codifica dei colori è basata su una condizione logica, imposta se applicare la formattazione barrata ai valori della regola.
strikethrough: true | false
fields
Specifica i campi a cui applicare la regola. Per impostazione predefinita, la regola si applica a tutti i campi numerici.
fields: [ view_name.field_name ]