Parametri del grafico a colonne per le dashboard LookML

Questa pagina descrive le opzioni per creare un elemento della dashboard LookML di type: looker_column con i parametri della dashboard LookML in un file dashboard.lkml.

Per informazioni sulla creazione di un grafico a colonne tramite la UI di Looker, consulta la pagina della documentazione Opzioni dei grafici a colonne.

Esempio di utilizzo


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_column
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
stacking: normal | percent | ''
show_dropoff: true | false
ordering: none | asc | desc
column_spacing_ratio: number between 0 and 1
column_group_spacing_ratio: number between 0 and 1
hide_legend: true | false
legend_position: center | left | right
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
colors: [css_color, css_color, …]
series_colors:
  series_name: css_color
  # Possibly more series color assignments

series_labels:
  'Series Name': desired series label
  # Possibly more series label assignments
series_types:
   series_name: column | line | area | scatter
   # Possibly more series visualization assignments
show_view_names: true | false

## VALUE PARAMETERS
show_value_labels: true | false
show_null_labels: true | false
label_color: [css_color, css_color, …]
font_size: Npx
label_rotation: N
label_value_format: 'value formatting string'
show_totals_labels: true | false
hidden_series: [series_name, series_name, …]
show_silhouette: true | false
totals_color: css_color

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
x_axis_reversed: true | false
show_x_axis_label: true | false
x_axis_label: desired x-axis label
show_x_axis_ticks: true | false
x_axis_gridlines: true | false
x_axis_label_rotation: N
x_axis_datetime_label: 'time formatting string'
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
y_axis_gridlines: true | false
y_axis_reversed: true | false
reference_lines:
  # reference line options
y_axis_zoom: true | false

## ADVANCED VISUALIZATION CONFIGURATION PARAMETERS
advanced_vis_config: 'Highcharts JSON snippet'

Definizioni dei parametri

Nome parametro Descrizione
Parametri di base
name (per gli elementi) Crea un elemento
title (per gli elementi) Modifica il modo in cui il nome di un elemento viene visualizzato dagli 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 layout: tile e layout: static
width (per gli elementi) Definisce la larghezza di un elemento in unità di tile_size per le dashboard 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 layout: static
left Definisce la posizione da sinistra a destra di un elemento in unità di tile_size per le dashboard layout: static
row Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per le dashboard layout: newspaper
col Definisce la posizione da sinistra a destra di un elemento in unità di colonne per le dashboard layout: newspaper
refresh (per gli elementi) Imposta l'intervallo di aggiornamento automatico dell'elemento
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 sottoposte a pivot per 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 del grafico
stacking Impila le serie una sopra l'altra per creare un grafico in pila
show_dropoff Aggiunge frecce che mostrano la variazione percentuale tra i punti dati
ordering Imposta l'ordine dei valori delle serie in un grafico a barre in pila o in pila 100%
column_spacing_ratio Imposta la spaziatura tra le colonne all'interno di un gruppo
column_group_spacing_ratio Imposta la spaziatura tra i gruppi di colonne su un valore compreso tra 0 e 1
hide_legend Nasconde la legenda del grafico
legend_position Specifica se la legenda viene visualizzata a sinistra, al centro o a destra del grafico
hidden_fields Specifica i campi da utilizzare nella query, ma da nascondere nel grafico
limit_displayed_rows Mostra o nasconde le righe in 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 delle serie
colors Imposta i colori delle serie del grafico in base all'ordine in cui vengono visualizzate
series_colors Imposta i colori delle serie del grafico in base al nome della serie
series_labels Modifica il modo in cui il nome di una serie viene visualizzato dagli utenti
series_types Combina i tipi di visualizzazione definendo il tipo per ogni serie
show_view_names Nasconde i nomi delle visualizzazioni dalle etichette dei grafici
Parametri dei valori
show_value_labels Mostra le etichette accanto ai punti dati
show_null_labels Determina se le etichette null devono essere mostrate in un grafico quando vengono mostrate le etichette
label_color Specifica un elenco di valori di colore separati da virgole
font_size Imposta la dimensione del carattere delle etichette dei valori
label_rotation Con stacking impostato sul valore predefinito (''), imposta la rotazione delle etichette dei valori su un valore compreso tra -360 e 360
label_value_format Specifica la formattazione in stile Excel per le etichette dei valori
show_totals_labels Con stacking impostato su normal, specifica se i totali vengono visualizzati per ogni gruppo in pila di punti dati in un grafico
hidden_series Nasconde una serie del grafico quando l'elemento viene caricato
show_silhouette Con stacking impostato su normal, mostra una rappresentazione leggermente ombreggiata di una serie disabilitata
totals_color Con stacking impostato su normal, specifica il colore delle etichette dei totali
Parametri dell'asse X
x_axis_scale Specifica come viene calcolata la scala dell'asse X
x_axis_reversed Specifica la direzione dell'asse X
show_x_axis_label Nasconde l'etichetta dell'asse X
x_axis_label Definisce un'etichetta personalizzata per l'asse X
show_x_axis_ticks Mostra le tacche sull'asse X
x_axis_gridlines Estende le linee della griglia dall'asse X
x_axis_label_rotation Ruota le etichette dell'asse X di un numero di gradi
x_axis_datetime_label Specifica una stringa di formato per le etichette dell'asse X, se sono date
x_axis_zoom Specifica se consentire lo zoom lungo l'asse X
Parametri dell'asse Y
y_axis_gridlines Estende le linee della griglia dall'asse Y
y_axis_reversed Imposta la direzione dell'asse X
reference_lines Aggiunge linee di riferimento a un grafico
y_axis_zoom Specifica se consentire lo zoom lungo l'asse Y. Disattivata se x_axis_zoom: false.
Parametri di configurazione della visualizzazione avanzata
advanced_viz_config Accetta uno snippet JSON HighCharts che può eseguire l'override di diverse impostazioni di visualizzazione

Parametri base

Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per 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 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 dedicata ai 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 indicati nel parametro elements quando utilizzi le dashboard layout: grid o nel parametro group degli elementi secondari quando organizzi gli elementi in un gruppo di riquadri (type: group).

- 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 nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

title può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai 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 predefinito è l'elemento name.

Considera questo esempio:

- name: sales_overview
  title: '1) Sales Overview'

Se hai utilizzato questo formato, l'elemento non verrà visualizzato come Panoramica delle vendite, ma 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 dedicata ai parametri della dashboard.

type può essere utilizzato anche nell'ambito di un join, come spiegato nella pagina della documentazione dedicata al parametro type (per i join).

type può essere utilizzato anche come parte di una dimensione, come descritto nella pagina della documentazione Tipi di dimensioni, filtri e parametri.

type può essere utilizzato anche come parte di una misura, descritta 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 | button | group

Per una panoramica dei diversi tipi di elementi della dashboard LookML, consulta la pagina della documentazione type (per le dashboard 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, descritta nella pagina della documentazione relativa ai 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 codice seguente 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 row, per le dashboard layout: newspaper.

Per impostazione predefinita, una dashboard con layout di giornale ha un'altezza degli elementi 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 in modo che sia alto 12 righe, ovvero il 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 nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per le 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 le dashboard layout: newspaper.

Una dashboard con layout di tipo giornale ha una larghezza predefinita di 24 colonne.

Ad esempio, il seguente codice imposta l'elemento su metà della 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 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 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 layout: static.

Ad esempio, il codice seguente 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 layout: newspaper, il parametro row definisce la riga su cui viene posizionato il bordo superiore di un elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, row definisce la posizione della riga dell'elemento rispetto alla parte superiore del contenitore del gruppo (row: 0).

Una dashboard inizia con la riga 0 nella parte superiore. Una dashboard con layout di tipo 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) occuperebbero per impostazione predefinita le righe 0-5.

Ogni riga è alta 50 pixel, il che significa che l'altezza predefinita dell'elemento di 6 righe è di 300 pixel.

Ad esempio, il seguente codice imposta un elemento da inserire nella seconda riga di elementi della dashboard, supponendo che gli elementi siano impostati sull'altezza predefinita:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    row: 6
    ...

col

Per le dashboard layout: newspaper, il parametro col definisce la colonna in cui è posizionato il bordo sinistro dell'elemento. Se l'elemento viene inserito in un gruppo di riquadri utilizzando il parametro group, col definisce la posizione della colonna dell'elemento rispetto al bordo sinistro del contenitore del gruppo (col: 0).

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di tipo 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) occuperebbero per impostazione predefinita le colonne 0-7.

Ad esempio, il seguente codice imposta un elemento da inserire 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 nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

Il parametro refresh consente a un elemento di ricaricarsi automaticamente a intervalli regolari, recuperando così dati aggiornati. Questa opzione è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio sulla TV di un ufficio. Tieni presente che la dashboard deve essere aperta in una finestra del browser affinché questo parametro abbia effetto. Questa impostazione non viene eseguita in background per "pre-riscaldare" la cache della dashboard.

La frequenza di aggiornamento può essere un numero qualsiasi (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 previsto.

note

Puoi aggiungere note descrittive agli elementi in questo modo:

- 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 verrà collapsed o expanded se è troppo grande per essere inserita in una singola riga all'interno della larghezza dell'elemento. Se scegli collapsed e la nota è troppo lunga, terminerà con dei puntini di sospensione cliccabili (...) che possono essere utilizzati 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 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 della dashboard LookML, devi specificare i valori almeno per i parametri di ricerca model e explore e almeno un campo deve essere specificato utilizzando il parametro dimensions o il parametro measures. Puoi anche utilizzare gli altri parametri di ricerca per controllare il modo in cui i dati vengono visualizzati in un elemento della dashboard.

model

Il parametro model definisce il modello da utilizzare per la query dell'elemento. Se non specificato, il valore predefinito sarà il modello 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 del 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 punto, il che è particolarmente utile se stai aggiornando il nome di un modello utilizzato da più elementi della dashboard.

Per ulteriori informazioni e un esempio di utilizzo delle costanti con le dashboard 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 nell'ambito di un modello, come spiegato nella pagina della documentazione dedicata al parametro explore.

explore può essere utilizzato anche come parte di un filtro della dashboard, descritto nella pagina della documentazione dedicata ai 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 del progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per explore. L'utilizzo di una costante consente di definire il nome di un'esplorazione in un unico punto, il che è particolarmente utile se stai aggiornando il nome di un'esplorazione utilizzata da più elementi della dashboard.

Per ulteriori informazioni e un esempio di 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 dell'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 il comportamento di ordinamento per la query dell'elemento. Elenca prima il campo di ordinamento principale, seguito da eventuali campi di ordinamento secondari. Utilizza la sintassi view_name.field_name per specificare la dimensione o la misura in base alla quale ordinare.

Se ometti il parametro sorts, l'elemento utilizza l'ordinamento predefinito di Looker. Gli ordinamenti crescenti non richiedono un suffisso, mentre quelli decrescenti richiedono il suffisso desc.

L'esempio seguente definisce un singolo ordinamento:

- name: orders_by_date
  sorts: order.order_date desc

L'esempio seguente definisce più ordinamenti:

- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

Se utilizzi le dimensioni pivot, puoi ordinare i risultati della query specificando il nome della misura, la direzione di ordinamento e il numero di indice basato su 0 della colonna di destinazione nella tabella dei dati. Ad esempio, il seguente elemento ordina in base alla prima colonna pivot utilizzando l'indice 0:

- name: orders_by_category
  sorts: [orders.count desc 0]

Per ordinare in base al totale della riga, specifica l'indice della colonna dei totali. Ad esempio, il seguente elemento ordina in base al totale della riga utilizzando l'indice 2, che rappresenta la colonna dei totali per una query con due colonne pivot:

- name: orders_by_cohort
  sorts: [users.count desc 2]

pivots

Il parametro pivots definisce le dimensioni che devono essere sottoposte a 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 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 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 nell'ambito di una dashboard, come descritto nella pagina della documentazione dedicata ai parametri della dashboard.

filters può essere utilizzato anche nell'ambito di una misura, come descritto nella pagina della documentazione dedicata al parametro filters.

Il parametro filters definisce i filtri non modificabili da utilizzare per la query dell'elemento. Se vuoi che i filtri possano essere modificati da un utente nella dashboard, devi configurarli utilizzando filters per le dashboard, quindi applicarli agli elementi utilizzando listen.

La sintassi di 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 della dashboard al filtro della dashboard.

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

Aggiungi il parametro listen a un elemento, quindi fornisci il nome del filtro seguito da due punti e un riferimento al campo a cui applicare il filtro, utilizzando la sintassi view_name.field_name. Ad esempio, potresti creare un filtro denominato 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 in questo modo:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

  elements:
 - name: orders_by_date
    listen:
      date: order.order_date
    ...

Se il filtro ascoltato è configurato con il parametro vis_filter: true, il controllo del filtro viene visualizzato in una barra dei filtri direttamente nella parte superiore del riquadro di visualizzazione, anziché nella barra dei filtri della dashboard in alto.

Per altri esempi di utilizzo dei parametri filters e listen per applicare i filtri della dashboard ai 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 relative ai fusi orari sono mostrate 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 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 sottoparametro join_fields per specificare come unire i risultati.

Il seguente codice LookML di esempio crea un elemento dei risultati uniti di type: looker_grid. In questo esempio, il parametro merged_queries viene utilizzato per creare un elemento della 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 della 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 ai visualizzatori della dashboard di perfezionare i risultati delle 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 diverse esplorazioni: company_info e companies. Vuoi unire le query sui campi ipo.stock_symbol, companies.name e companies.contact_email di ogni esplorazione per creare una query che restituisca i risultati per nome dell'azienda, email di contatto dell'azienda, anno dell'IPO, simbolo azionario, numero di dipendenti e numero di job. 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

Applicazione di filtri agli elementi di query uniti

L'esempio precedente di un elemento di query unita 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 primaria limitano i risultati alle aziende che hanno email di contatto e valutazioni valide. Questi filtri a livello di query pre-filtrano i dati prima di unire le query e non possono essere modificati dall'utente.

Puoi anche applicare i filtri della dashboard agli elementi delle query unite utilizzando il parametro listen all'interno della definizione di ogni query di origine. Ad esempio, supponiamo che tu abbia 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 come segue:

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.

Parametri del grafico

La maggior parte dei parametri descritti in questa sezione corrisponde alle opzioni della sezione Traccia dell'editor di visualizzazione per i grafici a colonne.

stacking

Il parametro stacking specifica il modo in cui le serie vengono raggruppate visivamente in un grafico.

  • normal: impila barre, linee e punti uno sopra l'altro, come in un normale grafico a colonne in pila.

  • percent: impila barre, linee e punti per riempire il grafico al 100% e imposta i valori dell'asse Y come percentuali.

  • '': barre, linee e punti non sono impilati, ma raggruppati.

stacking: normal | percent | ''

## default value: ''

show_dropoff

Il parametro show_dropoff attiva/disattiva la visualizzazione delle frecce di variazione percentuale nel grafico. Per ogni serie, queste frecce mostrano la percentuale del valore precedente da sinistra a destra.

show_dropoff: true | false

## default value: false

ordering

Il parametro ordering consente di ordinare ogni sezione di un grafico in pila o in pila percentuale in base alle dimensioni di ogni sezione.

  • none (o nessun valore specificato): i valori delle serie verranno ordinati in base alle loro posizioni nella tabella dei dati.
  • asc: i valori più piccoli della serie verranno posizionati in basso, con valori di dimensioni crescenti verso l'alto della pila di colonne.
  • desc: i valori più grandi verranno posizionati in basso, con valori di dimensioni decrescenti verso l'alto.

column_spacing_ratio

Il parametro column_spacing_ratio imposta la spaziatura tra le colonne all'interno di un gruppo. Questa opzione è disponibile per i grafici con stacking impostato sull'impostazione raggruppata predefinita, specificata utilizzando '' in LookML. Questo parametro accetta valori compresi tra 0 e 1. 0 è associato alla spaziatura minima tra le colonne di un gruppo, mentre 1 è associato alla spaziatura massima tra le colonne di un gruppo.


column_space_ratio: number between 0 and 1

column_group_spacing_ratio

Il parametro column_group_spacing_ratio imposta la spaziatura tra i gruppi di colonne. Questo parametro accetta valori compresi tra 0 e 1. 0 è associato alla spaziatura minima tra i gruppi di colonne e 1 è associato alla spaziatura massima tra i gruppi di colonne.


column_group_spacing_ratio: number between 0 and 1

hide_legend

Questa dichiarazione nasconderà la legenda dalla visualizzazione.

hide_legend: true | false

## default value: false

legend_position

Se hide_legend è impostato su false (e sono presenti più serie), puoi utilizzare il parametro legend_position per specificare se la legenda della serie verrà visualizzata a sinistra, al centro o a destra del grafico.

legend_position: center | left | right

## default value: false

hidden_fields

Il parametro hidden_fields indica quali campi, se presenti, vengono utilizzati nella query, ma nascosti nel grafico. I 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 in una visualizzazione, in base alla loro posizione nei risultati. Ad esempio, se la visualizzazione mostra una media mobile di 7 giorni, potresti voler nascondere le prime 6 righe. Se imposti questo valore 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 quali righe mostrare o nascondere in una visualizzazione. Consulta la sezione limit_displayed_rows per un esempio di utilizzo.

show_hide

Il sottoparametro show_hide imposta se nascondere o meno determinate righe dalla visualizzazione. Imposta show_hide su show per visualizzare solo un numero limitato di righe nella visualizzazione e imposta 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 nel set di risultati. Se imposti first_last su first, le prime righe vengono mostrate o nascoste, mentre se imposti first_last su last, le ultime righe vengono mostrate o nascoste.

num_rows

Il sottoparametro num_rows imposta il numero di righe da nascondere o mostrare. Ad esempio, num_rows: '10' mostrerà o nasconderà le prime o le ultime 10 righe del set di risultati della visualizzazione.

Parametri delle serie

I parametri descritti in questa sezione corrispondono alle opzioni della sezione Serie dell'editor di visualizzazione per i grafici a colonne.

colors

Il parametro colors specifica un elenco di colori per le serie. Il primo colore nell'elenco corrisponde alla prima serie di dati. Se sono presenti più serie rispetto ai colori elencati, i colori verranno riutilizzati dall'inizio.


colors: [blue, orange, yellow, red, purple]

Per tutti gli attributi del grafico che specificano un colore, il valore del colore può essere una stringa esadecimale, ad esempio #2ca6cd, o una stringa di colore con nome CSS, ad esempio mediumblue.

series_colors

Imposta i colori delle serie in base al nome della serie, utilizzando le coppie name: value.

Per un grafico con pivot, i nomi delle serie sono i nomi dei pivot.

series_colors:
  'Yes': skyblue
  'No': '#000000'

Per un grafico con più misure, i nomi delle serie sono i nomi dei campi delle misure.

series_colors:
  inventory_items.count: crimson
  orders.count: green

Se il nome della serie non è elencato in series_colors, il grafico utilizzerà per impostazione predefinita l'elenco di colori fornito in colors. Se colors non è impostato, il grafico utilizzerà la combinazione di colori predefinita.

series_labels

Imposta le etichette di una o più serie in base al nome della serie, utilizzando coppie name: label.

Per un grafico con pivot, i nomi delle serie sono i nomi dei pivot.

series_labels:
  'Yes': iOS Users
  'No': Android Users

Per un grafico con più misure, i nomi delle serie sono i nomi dei campi delle misure.

series_labels:
  inventory_items.count: Inventory
  orders.count: Orders

series_types

Il parametro series_type ti consente di utilizzare diversi tipi di grafici cartesiani nella stessa visualizzazione. Utilizza questo parametro per assegnare un tipo di grafico a ogni serie che vuoi modificare. Le opzioni di tipo sono line, column, bar, area e scatter.

series_types:
  series_a_name: column
  series_b_name: line

Per impostazione predefinita, tutte le serie vengono visualizzate nel tipo di grafico iniziale scelto. Puoi quindi modificare le singole serie.

show_view_names

Il parametro show_view_names determina se i nomi delle visualizzazioni vengono mostrati nelle etichette dei grafici, ad esempio i nomi degli assi e delle colonne.

show_view_names: true | false

## default value: true

Parametri dei valori

I parametri descritti in questa sezione corrispondono alle opzioni della sezione Valori dell'editor di visualizzazione per i grafici a colonne.

show_value_labels

Visualizza il valore di una barra, una linea o un punto accanto al punto dati.

show_value_labels: true | false

## default value: false

show_null_labels

Determina se le etichette devono essere mostrate per colonne o barre nulle, quando show_value_labels è impostato su true.

show_null_labels: true | false

## default value: false

labelColor

Se labelColorEnabled è impostato su true, utilizza il parametro labelColor per specificare un colore personalizzato per l'etichetta e le percentuali. Le etichette in cui labelPosition è impostato su inline verranno visualizzate nel colore scelto, mentre le etichette su entrambi i lati del grafico verranno visualizzate con un colore più scuro di circa il 40% rispetto a quello scelto.


labelColor: "#4FBC89"

font_size

Imposta la dimensione del carattere delle etichette dei valori utilizzando qualsiasi dimensione CSS valida, ad esempio 10px o 12px.


font_size: 14px

label_rotation

Imposta la rotazione delle etichette dei valori. Questo parametro accetta valori compresi tra -360 e 360, che indicano il numero di gradi di rotazione delle etichette. Questo parametro è disponibile solo quando stacking è impostato sul valore predefinito ('').


label_rotation: -45

label_value_format

Il parametro label_value_format specifica la formattazione da applicare a un valore, indipendentemente da qualsiasi formattazione applicata alla dimensione o alla misura sottostante. Il campo accetta la formattazione in stile Excel. Se label_value_format non è specificato, il valore verrà visualizzato nel formato della dimensione o della misura sottostante.

Puoi scoprire come specificare questi formati nella pagina della documentazione Aggiunta di una formattazione personalizzata ai campi numerici. Tuttavia, la formattazione dei colori non è supportata in Looker.

La formattazione utilizzata nel parametro della dashboard LookML label_value_format è la stessa utilizzata con il parametro LookML value_format, ad eccezione del fatto che il parametro LookML value_format richiede che la stringa di formattazione sia racchiusa tra virgolette doppie.


label_value_format: '0.00'

show_totals_labels

Imposta se visualizzare i totali per ogni gruppo di punti dati impilati in un grafico. Questo parametro è disponibile solo quando stacking è impostato su normal.


show_totals_labels: true | false

hidden_series

Il parametro hidden_series specifica quali serie verranno disattivate nel grafico, ovvero le serie verranno visualizzate nella legenda del grafico, ma in grigio. Gli utenti possono attivare le serie disattivate facendo clic su di esse nella legenda del grafico. Di conseguenza, hidden_series potrebbe non funzionare come previsto con hide_legend: true.

Per un grafico con pivot, i nomi delle serie sono i nomi dei pivot:

hidden_series: ['Yes', 'No']

Per un grafico con più misure, i nomi delle serie sono i nomi dei campi delle misure:

hidden_series: [inventory_items.count, orders.count]

Se utilizzato insieme al parametro show_silhouette, puoi specificare se le serie disattivate vengono mostrate come rappresentazione leggermente ombreggiata nel grafico stesso.

show_silhouette

Quando il parametro show_silhouette è impostato su true e stacking è impostato su normal, una serie disattivata verrà visualizzata come una sagoma leggermente ombreggiata.


show_silhouette: true | false

totals_color

Questo parametro definisce il colore delle etichette dei totali in un grafico. Il parametro totals_color è disponibile solo quando stacking è impostato su normal.


totals_color: "#2ca6cd"

Parametri dell'asse X

I parametri descritti in questa sezione corrispondono alle opzioni della sezione X dell'editor di visualizzazione per i grafici a colonne.

x_axis_scale

Questo parametro determina il modo in cui viene calcolata la scala dell'asse X.

  • auto: la scala verrà dedotta dai dati sottostanti. Questa è l'impostazione predefinita.
  • ordinal: i dati verranno tracciati come voci discrete distanziate in modo uniforme.
  • time: i dati verranno tracciati come ora e l'asse verrà etichettato in modo appropriato. Questa operazione non funzionerà se i dati sottostanti non possono essere convertiti in date.
x_axis_scale: auto | ordinal | time

## default value: auto

x_axis_reversed

Questo parametro imposta la direzione dell'asse X. Quando x_axis_reversed è impostato su false, i valori aumentano da sinistra a destra. Se è impostata su true, i valori diminuiscono da sinistra a destra.


x_axis_reversed: true | false

show_x_axis_label

Questo parametro determina se le etichette vengono visualizzate sull'asse X.

show_x_axis_label: true | false

## default value: true

x_axis_label

Questo parametro specifica un'etichetta per l'asse X. Puoi utilizzare questo parametro quando show_x_axis_label è impostato su true.

x_axis_label: Order Date

show_x_axis_ticks

Questo parametro determina se le etichette dei valori vengono visualizzate sull'asse X.

show_x_axis_ticks: true | false

## default value: true

x_axis_gridlines

Questo parametro determina se le linee della griglia vengono estese dall'asse X.

x_axis_gridlines: true | false

## default value: false

x_axis_label_rotation

Il parametro x_axis_label_rotation definisce la rotazione delle etichette dell'asse X in gradi. Questo parametro accetta valori compresi tra -360 e 360, che indicano il numero di gradi di rotazione delle etichette.

x_axis_label_rotation: -45

x_axis_datetime_label

Questo parametro specifica una stringa di formato per le etichette dell'asse X, se sono date. Se x_axis_scale non è impostato su time, non succede nulla.


x_axis_datetime_label: '%b %d'

Per informazioni sulla formattazione degli orari, consulta la pagina della documentazione Formattazione dell'ora per i grafici.

x_axis_zoom

Questo parametro specifica se gli utenti possono aumentare lo zoom sull'asse X della visualizzazione. Quando x_axis_zoom è impostato su true, lo zoom è disponibile. Quando x_axis_zoom è impostato su false, lo zoom non è disponibile.

Se x_axis_zoom è impostato su false, y_axis_zoom è disattivato.

x_axis_zoom: true | false

# default value: true

Parametri dell'asse Y

In fase di sviluppo: stiamo lavorando per aggiornare questa sezione della pagina. Nel frattempo, puoi consultare la pagina della documentazione Opzioni del grafico a colonne per visualizzare le opzioni del menu di visualizzazione equivalenti per l'asse Y.

I parametri descritti in questa sezione corrispondono alle opzioni della sezione Y dell'editor di visualizzazione per i grafici a colonne.

y_axis_gridlines

Questo parametro determina se le linee della griglia vengono estese dall'asse Y.

y_axis_gridlines: true | false

## default value: true

y_axis_reversed

Questo parametro imposta la direzione dell'asse Y. Quando y_axis_reversed è impostato su false, i valori aumentano lungo l'asse. Se è impostato su true, i valori diminuiscono lungo l'asse.


## y_axis_reversed: true | false

# default value: false

reference_lines

Questo parametro specifica un array di valori per specificare linee e regioni di riferimento.

Per informazioni sulla configurazione delle linee di riferimento, consulta la pagina della documentazione Parametri delle linee di riferimento della dashboard.


reference_lines:
   # reference line options

y_axis_zoom

Questo parametro specifica se gli utenti possono aumentare lo zoom sull'asse Y della visualizzazione. Quando y_axis_zoom è impostato su true, lo zoom è disponibile.

Quando y_axis_zoom è impostato su false, gli utenti non possono aumentare lo zoom su porzioni più piccole dell'asse Y. Tuttavia, gli utenti potrebbero comunque essere in grado di aumentare lo zoom su porzioni più piccole dell'asse X se il parametro x_axis_zoom è impostato su true.

Se x_axis_zoom è impostato su false, y_axis_zoom è disattivato.

y_axis_zoom: true | false

# default value: true

Parametri di configurazione della visualizzazione avanzata

I parametri descritti in questa sezione corrispondono agli override facoltativi della configurazione del grafico, che puoi applicare a un grafico facendo clic sul pulsante Modifica configurazione grafico nella sezione Traccia dell'editor di visualizzazione.

advanced_vis_config

Questo parametro accetta uno snippet JSON HighCharts che sostituisce diverse impostazioni di visualizzazione e apre nuove funzionalità. Consulta la pagina della documentazione Personalizzazione delle visualizzazioni utilizzando l'editor di configurazione dei grafici per esempi di utilizzo del JSON di HighCharts per ottenere casi d'uso comuni.


advanced_vis_config: "{ series: [{ formatters: [{ select: 'value >= 50', style: { color: 'orange' } }]}]}"

# This example changes the color to orange for any series value that is greater than or equal to 50.

# default value: null