Parametri del grafico a tabella per le dashboard LookML

Questa pagina mostra come aggiungere e personalizzare un elemento della dashboard LookML di type: looker_grid con i parametri della dashboard LookML in un file dashboard.lkml.

Per informazioni sulla creazione di un grafico a tabella tramite l'interfaccia utente di Looker, consulta la pagina della documentazione Opzioni dei grafici a tabella.

Esempio di utilizzo


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_grid
height: N
width: N
top: N
left: N
row: N
col: N
refresh: N (seconds | minutes | hours | days)
note_state: collapsed | expanded
note_display: above | below | hover
note_text: 'note text'

## QUERY PARAMETERS
model: model_name
explore: explore_name
fields: [view_name.field_name, view_name.field_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, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
subtotals: [view_name.field_name, view_name.field_name, …]
total: true | false
row_total: right | left | false
limit: N
column_limit: N
filters:
  view_name.field_name: 'Looker filter expression' | 'filter value'
filter_expression:  'Looker custom filter expression'
listen:
  dashboard_filter_name: view_name.field_name
query_timezone: 'specific timezone' | user_timezone
analysis_config: # can only be used when the Forecasting Labs feature is enabled
  forecasting:
  - confidence_interval: N
    field_name: view_name.field_name
    forecast_n: N
    forecast_interval: day | month | a time frame with dimension fill
    seasonality: N
merged_queries:
- 'primary query definition'
- 'next source query definition'
  join_fields:
  - field_name: view_name.field_name
    source_field_name: view_name.field_name

## COLUMN PARAMETERS
auto_size_all_columns: true | false
column_order: [view_name.field_name, view_name.field_name, …]
pinned_columns:
    view_name.field_name: left

## PLOT PARAMETERS
table_theme: editable | white | gray | transparent | unstyled
show_row_numbers: true | false
hide_totals: true | false
hide_row_totals: true | false
transpose: 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_text: true | false
show_view_names: true | false
size_to_fit: true | false
dynamic_fields:
- table_calculation: {'table calculation definition'}
- measure: {'custom measure or custom filtered measure definition'}
- dimension: {'custom dimension definition'}
series_labels:
    view_name.field_name: 'Series Label'
series_column_widths:
    view_name.field_name: N
series_cell_visualizations:
    view_name.field_name:
        is_active: true | false
        palette:
            palette_id: 'palette ID'
            collection_id: 'collection ID'
            custom_colors:
            - 'color value'
        value_display: true | false
series_text_format:
    view_name.field_name:
        fg_color: 'color value'
        bg_color: 'color value'
        bold: true | false
        italic: true | false
        align: left | center | right
series_collapsed:
    view_name.field_name: true | false
series_value_format:
    view_name.field_name:
        format_string: 'value formatting string'

## FORMATTING PARAMETERS
color_application:
    collection_id: 'collection ID'
    palette_id: 'palette ID'
header_font_color: 'color value'
header_background_color: 'color value'
header_text_alignment: left | center | right
header_font_size: N
rows_font_size: N
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) 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_state Definisce se la nota verrà compressa o espansa se è troppo grande per essere inserita in una singola riga all'interno della larghezza dell'elemento
note_display Definisce dove viene visualizzata la nota su un elemento
note_text Specifica il testo visualizzato nella nota
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
fields Definisce i campi da utilizzare per la query dell'elemento. Può essere utilizzato al posto di dimensions e measures.
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
fill_fields Definisce le dimensioni che utilizzano l'opzione di riempimento della dimensione
subtotals Definisce i campi di cui viene calcolato il totale parziale
total Specifica se i totali delle colonne vengono visualizzati per una visualizzazione a tabella
row_total Specifica se i totali delle righe vengono visualizzati per una visualizzazione tabella
limit Definisce il limite di righe da utilizzare per la query dell'elemento
column_limit Definisce il limite di colonne da utilizzare per la query dell'elemento
filters (per gli elementi) Definisce i filtri che non possono essere modificati per la query dell'elemento
filter_expression Definisce un filtro personalizzato che non può essere modificato 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
analysis_config Aggiunta 21.14 Definisce l'analisi di previsione da eseguire quando viene eseguita la query. Richiede l'abilitazione della funzionalità di Labs Previsione.
merged_queries Definisce una query di risultati uniti
Parametri delle colonne
auto_size_all_columns Ridimensiona automaticamente ogni colonna della tabella in base alla larghezza dell'intestazione della colonna o al valore dei dati più lungo, a seconda di quale sia più largo
column_order Ordina le colonne nel grafico a tabella
pinned_columns Definisce le colonne da bloccare sul lato sinistro del grafico a tabella
Parametri del grafico
table_theme Applica una delle cinque opzioni di colorazione della tabella a una visualizzazione della tabella
show_row_numbers Imposta 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 della tabella mostra i totali delle righe
transpose Consente di impostare se trasporre le righe della tabella in colonne
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
Parametri delle serie
truncate_text Abbrevia le intestazioni di colonna e il testo all'interno delle celle di dati con i puntini di sospensione (…)
show_view_names Mostra il nome della visualizzazione insieme al nome del campo per ogni intestazione di colonna
size_to_fit Ridimensiona automaticamente le larghezze di tutte le colonne in modo che la tabella si adatti perfettamente alla larghezza dell'elemento in cui viene visualizzata.
dynamic_fields Include calcoli tabulari o campi personalizzati nel grafico a tabella
series_labels Specifica un'etichetta personalizzata per ogni colonna della visualizzazione
series_column_widths Specifica larghezze specifiche per le colonne nella visualizzazione
series_cell_visualizations Specifica se le colonne utilizzano l'opzione di visualizzazione Visualizzazione celle. Questo parametro ha i sottoparametri is_active, palette e value_display.
series_text_format Specifica il layout del testo delle celle per ogni colonna. Questo parametro ha i parametri secondari fg_color, bg_color, bold, italic e align.
series_collapsed Specifica se una colonna con subtotali verrà visualizzata compressa
series_value_format Definisce il formato dei valori per una colonna utilizzando la formattazione personalizzata
Parametri di formattazione
color_application Applica i colori alle visualizzazioni delle celle e alla formattazione condizionale
header_font_color Applica un colore del carattere alle intestazioni di colonna
header_background_color Applica un colore agli sfondi delle intestazioni di colonna
header_text_alignment Applica l'allineamento a sinistra, a destra o al centro alle intestazioni di colonna
header_font_size Applica una dimensione del carattere alle intestazioni di colonna
rows_font_size Applica una dimensione del carattere al testo all'interno delle celle di dati
enable_conditional_formatting Imposta su true per definire le regole di codifica a 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 codificano con colori la visualizzazione della tabella

Parametri base

Quando definisci un elemento della dashboard LookML, devi specificare i valori almeno per i parametri name e type. Altri parametri di base come title, height e width influiscono sulla posizione e sull'aspetto 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_state

Il parametro note_state definisce se una nota verrà compressa o espansa 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. Se scegli expanded e la nota è lunga, questa verrà visualizzata su più righe.

note_display

Il parametro note_display definisce dove viene visualizzata una 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 un'icona ? per visualizzare la nota.

note_text

Il parametro note_text specifica il testo visualizzato in una nota dell'elemento.

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, il parametro measures o il parametro fields. Puoi anche utilizzare gli altri parametri di ricerca descritti in questa sezione 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.

fields

Il parametro fields definisce i campi da utilizzare per la query dell'elemento. Utilizza la sintassi view_name.dimension_name per specificare i campi.

## single field example
- name: orders_by_date
  fields: order.order_date

## multiple fields example
- name: orders_by_date
  fields: [order.order_date, order.order_count]

Se utilizzi il parametro fields, non è necessario utilizzare i parametri dimensions e measures.

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]

fill_fields

Il parametro fill_fields definisce le dimensioni che utilizzano l'opzione di riempimento della dimensione. Utilizza la sintassi view_name.dimension_name per specificare le dimensioni.

- name: orders_by_date
  fill_fields: [orders.created_date, orders.shipped_date]

subtotals

Il parametro subtotals definisce le dimensioni che utilizzano l'opzione subtotals. Utilizza la sintassi view_name.dimension_name per specificare le dimensioni.

subtotals: [products.department, distribution_centers.name]

total

Il parametro total imposta se mostrare o meno una riga dei totali nella parte inferiore della tabella. Per saperne di più, consulta Visualizzazione dei totali.

total: true | false

## default value: false

row_total

Il parametro row_total imposta se una colonna dei totali viene visualizzata a destra o a sinistra della tabella. Funziona solo se è presente una tabella pivot. Per saperne di più, consulta Visualizzazione dei totali.

row_total: right | left | false

## default value: false

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

column_limit

Il parametro column_limit definisce il limite di colonne da utilizzare per la query dell'elemento. Il limite si applica al numero di colonne dopo l'applicazione di eventuali pivot.

- name: orders_by_date
  column_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.

filter_expression

Il parametro filter_expression definisce un filtro personalizzato non modificabile 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.

- name: element_name
  filter_expression:
  - diff_days(${users.created_date},${user_order_facts.first_order_date}) > 60

La pagina della documentazione Espressioni di filtro di Looker elenca le espressioni di filtro di Looker.

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

analysis_config

I seguenti parametri secondari possono essere utilizzati per definire le analisi:

Puoi creare una previsione utilizzando una sintassi come questa:


  analysis_config:
    - forecasting:
      confidence_interval: 0.95
      field_name: orders.count
      forecast_n: 14
      forecast_interval: day
      seasonality: 7

forecasting

forecasting è un tipo di analisi che applica una previsione a una visualizzazione. La previsione consente agli analisti di aggiungere rapidamente proiezioni di dati a query di esplorazione nuove o esistenti per aiutare gli utenti a prevedere e monitorare punti dati specifici.

Per saperne di più, consulta la pagina della documentazione Previsione nelle visualizzazioni.

Per aggiungere previsioni alle visualizzazioni, deve essere attivata la funzionalità di Labs Previsioni.

confidence_interval

confidence_interval imposta i limiti dei valori dei dati previsti, che vengono inseriti come espressioni decimali di percentuali. confidence_interval è facoltativo e vuoto per impostazione predefinita.


confidence_interval: 0.99 | 0.98 | 0.95 | 0.90 | 0.80

Consulta la sezione Intervallo di previsione nella pagina della documentazione Previsione nelle visualizzazioni.

Per aggiungere previsioni alle visualizzazioni, deve essere attivata la funzionalità di Labs Previsioni.

field_name

field_name specifica i nomi delle misure, fino a cinque, da includere nelle previsioni.


field_name: view_name.field_name

forecast_n

forecast_n specifica la durata della previsione.


forecast_n: N # An integer that represents the length of the forecast

Consulta la sezione Lunghezza nella pagina della documentazione Previsione nelle visualizzazioni.

Per aggiungere previsioni alle visualizzazioni, deve essere attivata la funzionalità di Labs Previsioni.

forecast_interval

forecast_interval imposta l'intervallo di durata per cui prevedere i valori dei dati. forecast_interval viene compilato automaticamente in base alla dimensione del periodo di tempo nella query di Esplora.


forecast_interval: day | month # a timeframe with dimension fill

Consulta la pagina della documentazione relativa alla lunghezza.

Per aggiungere previsioni alle visualizzazioni, deve essere attivata la funzionalità di Labs Previsioni.

seasonality

seasonality consente agli analisti di tenere conto di cicli noti o tendenze di dati ripetitive in una previsione. seasonality è facoltativo e vuoto per impostazione predefinita.


seasonality: N # An integer that represents the number of rows over which a cycle or pattern repeats

L'impostazione della stagionalità Automatica è rappresentata da un valore seasonality vuoto.

Consulta la sezione Stagionalità nella pagina della documentazione Previsione nelle visualizzazioni.

Per aggiungere previsioni alle visualizzazioni, deve essere attivata la funzionalità di Labs Previsioni.

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 delle colonne

I seguenti parametri corrispondono alla possibilità di spostare e bloccare le colonne nei grafici a tabella.

auto_size_all_columns

Il parametro auto_size_all_columns ridimensiona automaticamente ogni colonna della tabella in base alla larghezza dell'intestazione della colonna o al valore dei dati più lungo, a seconda di quale sia più largo. Questo parametro sostituisce i parametri series_column_widths e size_to_fit, se definiti.

- name: orders_by_date
  auto_size_all_columns: true

column_order

Il parametro column_order definisce l'ordine delle colonne nel grafico a tabella.

- name: orders_by_date
  column_order: [customer.city, customer.state, customer.count]

pinned_columns

Il parametro pinned_columns definisce le colonne bloccate a sinistra del grafico a tabella.

- name: orders_by_date
  pinned_columns:
    orders.created_date: left
    distribution_centers.name: left

Parametri del grafico

I seguenti parametri corrispondono alle opzioni del menu Traccia dell'editor di visualizzazione per i grafici a tabella.

table_theme

Utilizza il parametro table_theme per applicare una delle seguenti opzioni di colorazione della tabella a un elemento della tabella:

  • editable: la tabella contiene dimensioni blu, misure arancioni e calcoli tabulari verdi.
  • white: l'intestazione della tabella è bianca, le righe di dati si alternano tra bianco e grigio e il testo è nero.
  • gray: l'intestazione della tabella è grigia, le righe di dati si alternano tra bianco e grigio chiaro e il testo è grigio scuro.
  • transparent: l'intestazione della tabella è completamente trasparente, le righe di dati si alternano tra completamente trasparenti e grigio traslucido e il colore del testo si regola da nero a bianco in base al colore di sfondo visibile. L'impostazione di table_theme su transparent può essere utile quando utilizzi una dashboard incorporata personalizzata in modo che il colore di sfondo del riquadro sia visibile attraverso la visualizzazione.
  • unstyled: l'intestazione della tabella e le righe di dati sono bianche e il testo è nero.

table_theme: editable | white | gray | transparent | unstyled

show_row_numbers

Il parametro show_row_numbers imposta se un numero di riga verrà visualizzato all'inizio di ogni riga della tabella.


show_row_numbers: true | false

hide_totals

Se l'esplorazione include i totali delle colonne, hide_totals imposta se la visualizzazione mostra i totali.


hide_totals: true | false

hide_row_totals

Se l'esplorazione include i totali delle righe, hide_row_totals imposta se i totali delle righe verranno visualizzati nella visualizzazione.


hide_row_totals: true | false

transpose

Il parametro transpose consente di trasporre le righe della tabella in colonne. Accetta true o false.

- name: orders_by_date
  transpose: true

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 seguenti parametri corrispondono alle opzioni del menu Serie dell'editor di visualizzazione per i grafici a tabella.

truncate_text

Il parametro truncate_text imposta se le intestazioni di colonna e il testo all'interno delle celle di dati devono essere abbreviati con i puntini di sospensione (…).


truncate_text: true | false

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

size_to_fit

Il parametro size_to_fit imposta se ridimensionare le larghezze di tutte le colonne in modo che la tabella si adatti perfettamente alla larghezza dell'elemento in cui viene visualizzata. Se il parametro auto_size_all_columns è impostato su true, esegue l'override di size_to_fit.


size_to_fit: true | false

dynamic_fields

Il parametro dynamic_fields e i relativi sottoparametri descrivono i calcoli tabulari o i campi personalizzati da utilizzare con la visualizzazione. Devi disporre dell'autorizzazione per creare campi personalizzati per aggiungere un description di massimo 255 caratteri o per utilizzare calculation_type per gruppi personalizzati o bin personalizzati. Devi disporre dell'autorizzazione per creare calcoli tabulari per aggiungere un description di massimo 255 caratteri ai calcoli tabulari o per utilizzare calculation_type per i calcoli rapidi.

I seguenti parametri secondari possono essere utilizzati per definire i campi dinamici:

Puoi creare un calcolo tabulare utilizzando una sintassi simile alla seguente:

dynamic_fields:
  - table_calculation: running_total
    label: Running Total of Items
    expression: running_total(${inventory_items.count})
    value_format_name: decimal_0
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number
    is_disabled: false

Puoi creare calcoli di scorciatoia per diversi tipi di calcolo utilizzando una sintassi simile alla seguente:

dynamic_fields:
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_column_sum
  table_calculation: percent_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent of previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_of_previous
  table_calculation: percent_of_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Percent change from previous - Orders Count
  value_format:
  value_format_name: percent_0
  calculation_type: percent_difference_from_previous
  table_calculation: percent_change_from_previous_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Rank of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: rank_of_column
  table_calculation: rank_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number
- category: table_calculation
  description: your description of up to 255 characters here
  label: Running total of Orders Count
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: running_total
  table_calculation: running_total_of_orders_count
  args:
  - orders.count
  _kind_hint: measure
  _type_hint: number

Puoi creare una misura personalizzata da utilizzare nella visualizzazione utilizzando una sintassi simile alla seguente:

dynamic_fields:
  - measure: avg_sale_price
    label: Average Sale Price
    based_on: products.sale_price
    type: average
    value_format_name: usd
    description: your description of up to 255 characters here
    _kind_hint: measure
    _type_hint: number

Puoi creare una misura personalizzata filtrata da utilizzare nella visualizzazione utilizzando una sintassi simile alla seguente:

dynamic_fields:
  - measure: order_count_for_25_47_year_olds
    based_on: order_items.order_count
    type: count_distinct
    label: Order Count for 25- to 47-Year-Olds
    description: your description of up to 255 characters here
    value_format: 00#
    _kind_hint: measure
    _type_hint: number
    filter_expression: "${users.age} >= 25 AND ${users.age} <= 47"

Puoi creare una dimensione personalizzata da utilizzare nella visualizzazione utilizzando una sintassi simile alla seguente:

dynamic_fields:
  - dimension: user_city_state
    label: User City and State
    expression: concat(${users.city}, ", ", ${users.state})
    description: your description of up to 255 characters here
    _kind_hint: dimension
    _type_hint: string

Puoi creare gruppi personalizzati per una dimensione da utilizzare nella visualizzazione utilizzando una sintassi simile alla seguente:

  - category: dimension
  description: 'States by region'
  label: State Groups
  value_format: ## this field is optional
  value_format_name: ## this field is optional
  calculation_type: group_by
  dimension: state_groups
  args:
  - users.state
  - - label: Pacific Northwest
      filter: Oregon,Idaho,Washington
  - Other
  _kind_hint: dimension
  _type_hint: string

Puoi creare bin personalizzati per una dimensione da utilizzare nella visualizzazione utilizzando una sintassi simile alla seguente:

- category: dimension
  description: Order item sale prices, in tiers of 10
  label: Sale Price Bins
  value_format:
  value_format_name:
  calculation_type: bin
  dimension: sale_price_bins
  args:
  - order_items.sale_price
  - '10'
  - '0'
  - '100'
  -
  - classic
  _kind_hint: dimension
  _type_hint: string

Puoi aggiungere più campi dinamici all'elemento. Non è necessario aggiungere i calcoli tabulari al parametro fields per visualizzarli, ma devi aggiungere altri tipi di campi dinamici a fields per visualizzarli.

table_calculation

Se stai definendo un calcolo tabulare, il sottoparametro table_calculation assegna un nome al calcolo tabulare. Questo è il nome da utilizzare quando fai riferimento al calcolo tabulare in LookML.

measure

Il sottoparametro measure definisce il nome di una misura personalizzata o di una misura personalizzata filtrata. Questo è il nome che utilizzi per fare riferimento alla misura in LookML.

dimension

Il sottoparametro dimension definisce il nome di una dimensione personalizzata. Questo è il nome da utilizzare per fare riferimento alla dimensione in LookML.

label

Il sottoparametro label definisce il titolo del campo dinamico come vuoi che venga visualizzato nella visualizzazione. Questo nome può essere uguale o diverso da quello specificato nei parametri secondari table_calculation, measure o dimension.

based_on

Se utilizzi una misura personalizzata o una misura personalizzata filtrata, il sottoparametro based_on identifica la misura su cui si basa, utilizzando la sintassi view_name.field_name.

type

Se utilizzi una misura personalizzata, il sottoparametro type identifica il tipo di aggregazione. Accetta count_distinct, sum, average, min, max o median.

description

Puoi aggiungere una descrizione di massimo 255 caratteri a qualsiasi campo personalizzato o calcolo tabulare con il sottoparametro description. Looker visualizza la descrizione quando l'utente fa clic sull'icona informazioni a destra del nome del campo nel selettore campi e quando l'utente passa il mouse sopra il nome della colonna in una tabella o in una visualizzazione di un grafico a tabella in un'esplorazione, una dashboard o un Look.

expression

Se utilizzi un calcolo tabulare, il sottoparametro expression definisce l'espressione Looker utilizzata per creare il calcolo tabulare.

filter_expression

Se utilizzi una misura filtrata personalizzata, il sottoparametro filter_expression definisce l'espressione Looker utilizzata per filtrare la misura.

value_format

Il sottoparametro facoltativo value_format definisce il formato del valore per un campo dinamico quando utilizzi la formattazione personalizzata. Se vuoi utilizzare un formato Looker predefinito, utilizza invece value_format_name.

value_format_name

Il sottoparametro facoltativo value_format_name applica un formato predefinito al campo dinamico. Se vuoi utilizzare un formato personalizzato, utilizza value_format.

calculation_type

Il sottoparametro calculation_type definisce il tipo di funzione Calcolo rapido o Gruppo per creare un calcolo tabulare o un gruppo personalizzato per una dimensione:

Opzioni dei campi personalizzati calculation_type:

  • group_by: raggruppa i valori delle dimensioni in etichette fisse personalizzate, in base a una condizione personalizzata specificata. Simile a CASE WHEN in SQL o al parametro di campo case di LookML.
  • bin: raggruppa i valori in bin o livelli personalizzati per le dimensioni di tipo numerico e le dimensioni personalizzate. Simile al tipo di dimensione LookML tier.

Opzioni dei calcoli tabulari calculation_type:

  • percent_of_column_sum: un valore di riga diviso per la somma dei valori nella colonna. Questo calcolo include solo i valori presenti nella tabella dei dati quando è stato raggiunto il limite di righe della query.
  • percent_of_previous: il valore di una riga corrente diviso per il valore della riga seguente.
  • percent_difference_from_previous: la differenza tra il valore della riga corrente e quello della riga seguente, divisa per il valore della riga seguente.
  • rank_of_column: il ranking del valore di una riga tra tutti i valori nella colonna. Questo calcolo include solo i valori presenti nella tabella dei dati quando è stato raggiunto il limite di righe della query.
  • running_total: la somma cumulativa del valore della riga corrente e di tutti i valori delle righe precedenti nella colonna.
  • percent_of_previous_column: per i campi sottoposti a pivot, il valore della colonna attuale viene diviso per il valore della colonna a sinistra.
  • percent_change_from_previous_column: per i campi sottoposti a pivot, la differenza tra il valore della colonna attuale e quello della colonna a sinistra, divisa per il valore della colonna a sinistra.
  • percent_of_row: per i campi sottoposti a pivot, la percentuale del valore della colonna attuale divisa per la somma delle righe del campo.
  • running_row_total: per i campi sottoposti a pivot, la somma cumulativa della colonna attuale e di tutte le colonne precedenti in questa riga.

args per i gruppi personalizzati

Se utilizzi gruppi personalizzati per una dimensione, args specifica gli argomenti per l'applicazione di etichette fisse ai valori delle dimensioni. args ha il seguente formato:

args:
- view_name.field_name
  - label: specified custom label
    filter: condition for values
  - label: another specified custom label
    filter: a different condition for values
- Other ## An optional customizable group label for values that do not meet specified conditions.

Puoi aggiungere tutte le condizioni label e filter necessarie, a seconda del numero di gruppi che vuoi creare.

Per riferimento, vedi l'esempio precedente.

args per i bin personalizzati

Se utilizzi bin personalizzati per una dimensione numerica, args specifica gli argomenti per l'applicazione di livelli fissi ai valori delle dimensioni. args ha il seguente formato:

  args:
  - view_name.field_name
  - bin_size ## The numeric interval on which to base each bin, in single quotes
  - min ## The numeric value of the minimum bin size, in single quotes
  - max ## The numeric value of the maximum bin size, in single quotes
  - override ## A value will only appear when a custom bin uses a Custom-sized bin type.
  - style ## The bin display style. Currently, only classic is supported.

Per riferimento, vedi l'esempio precedente.

args per i calcoli delle scorciatoie

Il sottoparametro args consente di specificare i nomi dei campi numerici che utilizzi per un calcolo rapido. Un argomento ha il seguente formato:

- args:
  - view_name.field_name   ## the field on which the calculation is based

Per riferimento, vedi l'esempio precedente.

_kind_hint

Il sottoparametro facoltativo _kind_hint identifica se il campo dinamico restituisce una dimensione o una misura. Accetta i valori dimension e measure.

_type_hint

Il sottoparametro facoltativo _type_hint identifica il tipo di dati che l'espressione del campo dinamico deve produrre.

is_disabled

Il sottoparametro facoltativo is_disabled specifica se un calcolo tabulare viene visualizzato nella visualizzazione e nell'esplorazione sottostante. Accetta i valori true e false.

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_column_widths

Imposta le larghezze di una o più colonne in base al nome della serie. Se il parametro auto_size_all_columns è impostato su true, esegue l'override di series_column_widths.

series_column_widths:
  order_times.shipping_time: 50
  orders.count: 60

series_cell_visualizations

Specifica se una o più colonne utilizzano l'opzione Visualizzazione cella indicando il nome della serie utilizzando il formato view_name.field_name. series_cell_visualizations ha i sottoparametri is_active, palette e value_display.

series_cell_visualizations:
  order_items.count:
    is_active: true
    palette:
      palette_id: my-custom-colors-sequential-0
      collection_id: my-custom-colors
    value_display: true

is_active

Il sottoparametro facoltativo is_active accetta true o false per indicare se le visualizzazioni a barre sono attivate per la serie. Se is_active non è definito, il valore predefinito è true.

palette

Il sottoparametro palette è facoltativo. Se non viene utilizzata, la tavolozza predefinita sarà una tavolozza divergente nella raccolta di colori predefinita dell'istanza.

Se viene utilizzato palette, i parametri secondari palette_id e collection_id applicano i colori di una tavolozza specifica alle visualizzazioni a barre. Per palette_id, devi utilizzare l'ID di una tavolozza sequenziale o divergente. Per saperne di più sugli ID tavolozza e sugli ID raccolta di colori, consulta la sezione color_application.

palette ha un parametro secondario alternativo, custom_colors, che imposta da due a cinque colori personalizzati da utilizzare per le barre:

series_cell_visualizations:
  order_items.count:
    palette:
      custom_colors:
      - orange
      - "#0000ff"
      - red

value_display

Il sottoparametro facoltativo value_display accetta true o false per indicare se i valori di ogni cella di dati vengono mostrati insieme alla visualizzazione della cella. Se value_display non è definito, il valore predefinito è true.

series_text_format

Il parametro series_text_format e i relativi sottoparametri specificano il layout del testo delle celle per ogni colonna. La serie da formattare è indicata utilizzando la sintassi view_name.field_name e i sottoparametri descrivono la formattazione.

Tutti i parametri secondari sono facoltativi; utilizza solo quelli di cui hai bisogno.

  series_text_format:
    order_items.shipping_time:
      align: right
    order_items.shipped_date:
      align: center
      fg_color: "#EA8A2F"
      bg_color: "#64518A"
      bold: true
      italic: true

fg_color

Il sottoparametro fg_color indica il colore del carattere del testo della cella. Il valore del colore può essere una stringa esadecimale, ad esempio #2ca6cd, o una stringa di colore con nome CSS, ad esempio mediumblue.

bg_color

Il sottoparametro bg_color indica il colore di sfondo della cella. Il valore del colore può essere una stringa esadecimale, ad esempio #2ca6cd, o una stringa di colore con nome CSS, ad esempio mediumblue.

bold

Il sottoparametro bold indica se il testo della cella è in grassetto e accetta true o false.

italic

Il sottoparametro italic indica se il testo della cella è in corsivo e accetta true o false.

align

Il sottoparametro align indica l'allineamento del testo della cella e accetta left, center o right.

series_collapsed

Il parametro series_collapsed definisce se comprimere o espandere i subtotali per una determinata serie. Identifica la serie utilizzando la sintassi view_name.field_name e true o false.

series_collapsed:
  users.city: false
  users.state: true

Se la colonna è compressa, i singoli elementi che compongono il subtotale verranno visualizzati facendo clic sulla freccia sul lato sinistro della cella di dati.

series_value_format

Il parametro series_value_format specifica la formattazione da applicare a una serie, indipendentemente dalla formattazione applicata alla dimensione o alla misura sottostante. Se series_value_format non è specificato, il valore viene visualizzato nel formato della dimensione o della misura sottostante.

Identifica la serie da formattare utilizzando la sintassi view_name.field_name.

Il sottoparametro format_string consente di definire il formato della serie utilizzando la formattazione in stile Excel.

series_value_format:
  products.retail_price:
    format_string: "$#,##0.00"

Puoi anche definire la formattazione in questo modo:


series_value_format:
  order_items.count: "00#"

La formattazione utilizzata nel sottoparametro format_string è la stessa utilizzata con il parametro LookML value_format. Puoi scoprire come specificare questi formati nella pagina della documentazione Aggiunta di una formattazione personalizzata ai campi numerici.

Parametri di formattazione

I seguenti parametri corrispondono alle opzioni del menu Formattazione dell'editor di visualizzazione per i grafici a tabella.

color_application

Il parametro color_application e i relativi sottoparametri collection_id e palette_id possono essere utilizzati per applicare una raccolta di colori e una tavolozza specifiche a un elemento della 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 della tavolozza che vuoi utilizzare, puoi inserire questi ID nei sottoparametri collection_id e palette_id. Un ID collezione o un ID tavolozza può essere un codice alfanumerico o basarsi sul nome della collezione di colori. I codici alfanumerici vengono utilizzati per le raccolte native di Looker. Sono specifici per l'istanza e hanno il seguente 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 trasferibili tra le istanze e hanno il seguente 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 tua 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 di quel contenuto utilizzando l'interfaccia utente. Una volta fatto, puoi seguire i passaggi per ottenere il LookML della dashboard, copiare il LookML generato e incollarlo nella sezione color_application.

header_font_color

Il parametro header_font_color applica un colore del carattere alle intestazioni di colonna.

Il valore del colore può essere una stringa esadecimale, ad esempio #2ca6cd, o una stringa di colore con nome CSS, ad esempio mediumblue.


header_font_color: purple

Il colore predefinito dipende dal tema della tabella definito utilizzando il parametro table_theme.

header_background_color

Il parametro header_background_color applica un colore allo sfondo delle intestazioni di colonna.

Il valore del colore può essere una stringa esadecimale, ad esempio #2ca6cd, o una stringa di colore con nome CSS, ad esempio mediumblue.


header_background_color: #add8e6

Il colore predefinito dipende dal tema della tabella definito utilizzando il parametro table_theme.

header_text_alignment

Il parametro header_text_alignment applica l'allineamento left, right o center alle intestazioni di colonna.


header_text_alignment: center

L'allineamento predefinito è left.

header_font_size

Il parametro header_font_size applica una dimensione del carattere da 1 a 99 alle intestazioni di colonna.


header_font_size: 16

La dimensione predefinita per i caratteri di intestazione e riga è 12.

rows_font_size

Il parametro rows_font_size applica una dimensione del carattere compresa tra 1 e 99 al testo all'interno delle celle di dati, ma non alle intestazioni di colonna.


rows_font_size: 8

La dimensione predefinita per i caratteri di intestazione e riga è 12.

enable_conditional_formatting

Se imposti enable_conditional_formatting su true, puoi definire regole che codificano per colore la visualizzazione della tabella, su una scala o specificando i valori di interesse.


enable_conditional_formatting: true | false

conditional_formatting_include_totals

Se enable_conditional_formatting è impostato su true, conditional_formatting_include_totals specifica se i totali sono inclusi nello schema di codifica a 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 zero.


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 i colori della 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 codificare i valori con un colore lungo una scala o in base a una condizione logica.

Se utilizzi una scala di colori per i valori, puoi impostare type su along a scale....

Se utilizzi la codifica a colori dei valori 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 per value.
  • not equal to: la regola si applica ai valori non uguali al numero specificato per value.
  • greater than: la regola si applica ai valori maggiori del numero specificato per value.
  • less than: la regola si applica ai valori inferiori al numero specificato per value.
  • between: la regola si applica ai valori compresi tra i due numeri specificati per value.
  • not between: la regola si applica ai valori che non sono compresi tra i due numeri specificati per value.
  • 'null': la regola si applica solo ai valori null.
  • not null: la regola si applica solo ai valori non nulli.

type: along a scale... | equal to | not equal to | less than | between | not between | 'null' | not null

value

Se utilizzi colori codificati per i valori in base a 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, se type è impostato su between o not between, un insieme di due numeri.


value: N | [N, N]

background_color

Se la codifica a 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 colore 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 del 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 specifiche a una regola di formattazione condizionale.

Puoi aggiungere colori a una dashboard LookML in base all'ID raccolta e all'ID tavolozza, se li hai. Puoi anche utilizzare la UI per trovare i colori che preferisci e generare il codice LookML per aggiungerli alla tua dashboard. Vai a un contenuto definito dall'utente (ad esempio un look, una dashboard o un'esplorazione) e applica i colori che preferisci alla visualizzazione di quel contenuto utilizzando l'interfaccia utente. A questo punto, puoi seguire i passaggi per ottenere il LookML della dashboard, copiare il LookML generato e incollarlo nella sezione color_application. Per una panoramica delle raccolte di colori predefinite di Looker, consulta la pagina della documentazione Raccolte di colori.

Il sottoparametro options può essere utilizzato quando 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 suddivide i dati in quel numero di gruppi. Se questo parametro non viene utilizzato, i dati vengono colorati in base a un gradiente che copre l'intera tavolozza. Accetta valori compresi tra 2 e 100.
  • mirror: se impostato su true, 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. Accetta true o false.
  • constraints: questo parametro imposta l'intervallo di dati a cui viene applicata 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 del colore. Accetta true o false.

bold

Quando utilizzi la codifica colore in base a una condizione logica, imposta se applicare il grassetto ai valori a cui si applica la regola.


bold: true | false

italic

Quando utilizzi la codifica colore in base a una condizione logica, imposta se applicare il corsivo ai valori a cui si applica la regola.


italic: true | false

strikethrough

Quando utilizzi la codifica colore in base a 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 ]