Parametri del grafico a cascata per le dashboard LookML

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

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

Esempio di utilizzo

Un N indica che è richiesto un valore numerico. Le virgolette singole indicano il testo descrittivo e non devono essere incluse nel codice live.


## BASIC PARAMETERS
name: element_name
title: 'Element Title'
type: looker_waterfall
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, …]
fill_fields: [view_name.field_name, view_name.field_name, …]
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
hidden_fields: [view_name.field_name, view_name.field_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

## SERIES PARAMETERS
up_color: "hex string" | 'CSS named color string'
down_color: "hex string" | 'CSS named color string'
total_color: "hex string" | 'CSS named color string'
color_application:
  collection_id: 'collection ID'
  palette_id: 'palette ID'
  options:
    reverse: true | false

## VALUE PARAMETERS
show_value_labels: true | false
label_color: ['color value']

## X-AXIS PARAMETERS
x_axis_scale: auto | ordinal | time
show_x_axis_label: true | false
show_x_axis_ticks: true | false
x_axis_zoom: true | false

## Y-AXIS PARAMETERS
show_y_axis_labels: true | false
show_y_axis_ticks: true | false
y_axis_gridlines: true | false
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 l'elemento
title (per gli elementi) Modifica il modo in cui il nome dell'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 dell'elemento in unità di tile_size per i dashboard layout: tile e layout: static
width (per gli elementi) Definisce la larghezza dell'elemento in unità di tile_size per i dashboard layout: tile e layout: static
top Definisce la posizione dall'alto verso il basso dell'elemento in unità di tile_size per i dashboard layout: static
left Definisce la posizione da sinistra a destra dell'elemento in unità di tile_size per i dashboard layout: static
row Definisce la posizione dall'alto verso il basso di un elemento in unità di righe per i dashboard layout: newspaper
col Definisce la posizione da sinistra a destra di un elemento in unità di colonne per i 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 rientrare in una singola riga all'interno della larghezza dell'elemento
note_display Definisce dove viene visualizzata la nota sull'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
fill_fields Definisce le dimensioni che utilizzano l'opzione Riempimento dimensioni
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
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)
hidden_fields Specifica i campi da utilizzare nella query, ma da nascondere nel grafico
query_timezone Definisce il fuso orario da utilizzare quando viene eseguita la query
merged_queries Definisce una query di Risultati uniti
Parametri della serie
up_color Imposta il colore delle barre con valori positivi nel grafico.
down_color Imposta il colore delle barre dei valori negativi nel grafico.
total_color Imposta il colore della barra del valore totale nel grafico.
color_application Applica una raccolta di colori e una tavolozza al grafico.
Parametri di valore
show_value_labels Mostra le etichette per ogni barra di dati
label_color Specifica un valore di colore per le etichette
Parametri dell'asse X
x_axis_scale Specifica come viene calcolata la scala dell'asse X
show_x_axis_label Mostra o nasconde l'etichetta dell'asse X
show_x_axis_ticks Mostra i valori sull'asse X.
x_axis_zoom Specifica se consentire lo zoom lungo l'asse X
Parametri dell'asse Y
show_y_axis_labels Mostra o nasconde l'etichetta dell'asse Y.
show_y_axis_ticks Mostra i valori sull'asse Y.
y_axis_gridlines Estende le linee della griglia dall'asse Y
y_axis_zoom Specifica se consentire lo zoom lungo l'asse Y. Disattivato se x_axis_zoom: false.
Parametri di configurazione della visualizzazione avanzata
advanced_viz_config Accetta uno snippet JSON HighCharts che può ignorare diverse impostazioni di visualizzazione

Parametri di base

Quando definisci un elemento del dashboard LookML, devi specificare i valori per almeno i parametri di base name e type. Altri parametri di base, come title, height e width, influiscono sull'aspetto e sulla posizione dell'elemento in una dashboard.

name

Questa sezione si riferisce al parametro name che fa parte di un elemento del dashboard.

name può essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

Ogni dichiarazione name crea un nuovo elemento della dashboard e gli assegna un nome. I nomi degli elementi devono essere univoci. A volte i nomi vengono citati nel parametro elements quando utilizzi i dashboard layout: grid.

- name: orders_by_date

title

Questa sezione si riferisce al parametro title che fa parte di un elemento del dashboard.

title può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

title può essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

Il parametro title ti consente di modificare il modo in cui il nome di un elemento viene visualizzato dagli utenti. Se non specificato, il titolo corrisponde per impostazione predefinita all'elemento name.

Considera questo esempio:

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

Se hai utilizzato questo formato, anziché visualizzare l'elemento come Panoramica delle vendite, lo vedrai come 1) Panoramica delle vendite.

type

Questa sezione si riferisce al parametro type che fa parte di un elemento del dashboard.

type può essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

type può essere utilizzato anche nell'ambito di un'unione, come descritto nella pagina della documentazione relativa al parametro type (per le unioni).

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, come descritto nella pagina della documentazione Tipi di misure.

Il parametro type determina il tipo di visualizzazione da utilizzare nell'elemento.

- name: element_name
  type: text | looker_grid | table | single_value | looker_single_record |
        looker_column | looker_bar | looker_scatter | looker_line | looker_area |
        looker_pie | looker_donut_multiples | looker_funnel | looker_timeline |
        looker_map | looker_google_map | looker_geo_coordinates | looker_geo_choropleth | looker_waterfall | looker_wordcloud | looker_boxplot

Per una panoramica dei diversi tipi di elementi delle dashboard LookML, consulta la pagina di documentazione type (per le dashboard LookML).

height

Questa sezione si riferisce al parametro height che fa parte di un elemento del dashboard.

height può essere utilizzato anche nell'ambito di una riga del dashboard, come descritto nella pagina della documentazione Parametri del dashboard.

Per le dashboard con layout tile o static

Il parametro height definisce l'altezza di un elemento, in unità di tile_size (definita in pixel), per i dashboard layout: tile e layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e height: 4, rendendo l'elemento orders_by_date alto 400 pixel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    height: 4
    ...

Per le dashboard con layout newspaper

Il parametro height definisce l'altezza di un elemento, in unità di riga, per i dashboard layout: newspaper.

Un prospetto con layout a giornale ha un'altezza predefinita dell'elemento di 6 righe, ovvero circa 300 pixel. L'altezza minima è di una riga per i dashboard con un parametro preferred viewer impostato su dashboards-next. L'altezza minima è di 2 righe per i dashboard con un parametro preferred viewer impostato su dashboards.

Ad esempio, il seguente codice imposta un elemento in modo che sia alto 12 righe, ovvero il doppio degli altri elementi impostati sul valore predefinito:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    height: 12
    ...

width

Questa sezione si riferisce al parametro width che fa parte di un elemento del dashboard.

width può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

Il parametro width definisce la larghezza di un elemento, in unità di tile_size, per i dashboard layout: tile e layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e width: 4, rendendo l'elemento orders_by_date largo 400 pixel.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    width: 4
    ...

Il parametro width definisce la larghezza di un elemento, in unità di colonne, per i dashboard layout: newspaper.

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

Ad esempio, il seguente codice imposta l'elemento sulla metà della larghezza del dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    width: 12
    ...

top

Il parametro top definisce la posizione dall'alto verso il basso di un elemento, in unità di tile_size, per i dashboard layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e top: 4, posizionando il bordo superiore dell'elemento orders_by_date a 400 pixel dalla parte superiore del dashboard.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    top: 4
    ...

left

Il parametro left definisce la posizione da sinistra a destra di un elemento, in unità di tile_size, per i dashboard layout: static.

Ad esempio, il seguente codice specifica tile_size: 100 e left: 4, posizionando il bordo sinistro dell'elemento orders_by_date a 400 pixel dal lato sinistro della dashboard.

- dashboard: sales_overview
  tile_size: 100
  ...

  elements:
  - name: orders_by_date
    left: 4
    ...

row

Per i dashboard layout: newspaper, il parametro row definisce la riga in cui viene posizionato il bordo superiore di un elemento.

Una dashboard inizia con la riga 0 nella parte superiore della dashboard. Una dashboard con layout a giornale ha un'altezza predefinita degli elementi di 6 righe, il che significa che gli elementi della dashboard nella parte superiore di una dashboard (row: 0) occuperanno per impostazione predefinita le righe 0-5.

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

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

- dashboard: sales_overview
  layout: newspaper
  ...

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

col

Per i dashboard layout: newspaper, il parametro col definisce la colonna in cui viene posizionato il bordo sinistro dell'elemento.

Le dashboard sono suddivise in 24 colonne. Una dashboard inizia con la colonna 0 a sinistra. Una dashboard con layout di giornale ha una larghezza predefinita degli elementi di 8 colonne, il che significa che gli elementi della dashboard a sinistra di una dashboard (col: 0) occuperanno per impostazione predefinita le colonne 0-7.

Ad esempio, il seguente codice imposta un elemento da inserire nella terza colonna degli elementi nel dashboard:

- dashboard: sales_overview
  layout: newspaper
  ...

  elements:
  - name: orders_by_date
    col: 16
    ...

refresh

Questa sezione si riferisce al parametro refresh che fa parte di un elemento del dashboard.

refresh può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

Il parametro refresh consente a un elemento di ricaricarsi automaticamente a intervalli periodici, recuperando così dati aggiornati. Questo è spesso utile in contesti in cui una dashboard viene visualizzata costantemente, ad esempio su una TV in ufficio. Tieni presente che il parametro ha effetto solo se la dashboard è aperta in una finestra del browser. Questa impostazione non viene eseguita in background per "preriscaldare" la cache della dashboard.

La frequenza di aggiornamento può essere qualsiasi numero (senza decimali) di secondi, minuti, ore o giorni. Ad esempio:

- name: orders_by_date
  refresh: 2 hours

Presta attenzione quando imposti intervalli di aggiornamento brevi. Se la query alla base dell'elemento richiede molte risorse, alcuni elementi potrebbero sovraccaricare il database più del dovuto.

note_state

Il parametro note_state definisce se una nota verrà compressa o espansa se è troppo grande per rientrare in una singola riga all'interno della larghezza dell'elemento. Se scegli collapsed e la nota è troppo lunga, terminerà con dei puntini di sospensione (...) su cui è possibile fare clic per leggere la nota completa. Se scegli expanded e la nota è lunga, occuperà più righe.

note_display

Il parametro note_display definisce dove viene visualizzata una nota in un elemento. above posiziona la nota nella parte superiore di un elemento, below la posiziona nella parte inferiore di un elemento e hover richiede all'utente di passare il mouse sopra 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 del dashboard LookML, devi specificare i valori per almeno 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 per controllare la modalità di visualizzazione dei dati in un elemento della dashboard.

model

Il parametro model definisce il modello da utilizzare per la query dell'elemento. Se non specificato, il valore predefinito è il modello in cui si trova la dashboard.

- name: orders_by_date
  model: ecommerce

Il parametro model accetta costanti LookML. Puoi definire una costante nel file manifest per il tuo progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per model. L'utilizzo di una costante consente di definire il nome di un modello in un unico posto, il che è particolarmente utile se stai aggiornando il nome di un modello utilizzato da più elementi del dashboard.

Per ulteriori informazioni ed esempi sull'utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.

explore

Questa sezione si riferisce al parametro explore che fa parte di un elemento del dashboard.

explore può essere utilizzato anche nell'ambito di un modello, come descritto nella pagina della documentazione dedicata al parametro explore.

explore può essere utilizzato anche come parte di un filtro della dashboard, come descritto nella pagina della documentazione Parametri della dashboard.

Il parametro explore definisce l'esplorazione da utilizzare per la query dell'elemento.

- name: orders_by_date
  explore: order

Il parametro explore accetta costanti LookML. Puoi definire una costante nel file manifest per il tuo progetto, quindi utilizzare la sintassi "@{constant_name}" per impostare la costante come valore per explore. L'utilizzo di una costante ti consente di definire il nome di un'esplorazione in un unico posto, il che è particolarmente utile se stai aggiornando il nome di un'esplorazione utilizzata da più elementi del dashboard.

Per ulteriori informazioni ed esempi sull'utilizzo delle costanti con le dashboard LookML, consulta la pagina della documentazione del parametro constant.

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 devi 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 sull'elemento. Utilizza la sintassi view_name.measure_name per specificare la misura. Non includere measures se la query non ne ha.

## single measure example
- name: orders_by_date
  measures: order.count

## multiple measure example
- name: orders_by_date
  measures: [order.count, order_item.count]

sorts

Il parametro sorts definisce gli ordinamenti da utilizzare per la query dell'elemento. L'ordinamento principale è elencato per primo, seguito dall'ordinamento secondario e così via. Utilizza la sintassi view_name.field_name per specificare la dimensione o la misura. Non includere sorts se vuoi utilizzare l'ordinamento predefinito di Looker. Gli ordinamenti decrescenti hanno il suffisso desc, mentre quelli crescenti non ne hanno bisogno.

## single sort example
- name: orders_by_date
  sorts: order.order_date desc

## multiple sort example
- name: orders_by_date
  sorts: [order.order_date desc, customer.name]

fill_fields

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

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

limit

Il parametro limit definisce il limite di righe da utilizzare per la query dell'elemento. Il limite si applica al numero di righe prima dell'applicazione di eventuali tabelle pivot.

- name: orders_by_date
  limit: 100

filters

Questa sezione si riferisce al parametro filters che fa parte di un elemento del dashboard.

filters può essere utilizzato anche nell'ambito di una dashboard, come descritto nella pagina della documentazione 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 un utente possa modificare i filtri nella dashboard, devi configurarli utilizzando filters per le dashboard, quindi applicarli agli elementi utilizzando listen.

La sintassi per filters è:

- name: element_name
  filters:
    orders.created_date: 2020/01/10 for 3 days
    orders.status: Shipped
    # You can create multiple filter statements

Ogni filtro può accettare un'espressione di filtro di Looker o una costante di valore. Puoi anche utilizzare le variabili Liquid _localization o _user_attributes nell'espressione di filtro per valori di filtro flessibili.

filter_expression

Il parametro filter_expression definisce un filtro personalizzato non modificabile per la query dell'elemento. Se vuoi che un utente possa modificare i filtri nella dashboard, devi configurarli utilizzando filters per le dashboard, quindi applicarli agli elementi utilizzando listen.

- 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 del dashboard al filtro del dashboard.

La sintassi per listen è la seguente:

- name: element_name
  listen:
    filter_name_goes_here: dimension or measure on which to apply
                           the filter using view_name.field_name syntax
    # You can add more than one listen statement

Aggiungi il parametro listen a un elemento, quindi fornisci il nome del filtro seguito da due punti e da un riferimento al campo a cui deve essere applicato il filtro, utilizzando la sintassi view_name.field_name. Ad esempio, potresti creare un filtro chiamato Data che richiede a un utente di inserire una data nel campo del filtro nell'interfaccia utente. Puoi quindi applicare il valore inserito dall'utente all'elemento orders_by_date nel seguente modo:

- dashboard: sales_overview
  ...

  filters:
  - name: date
    type: date_filter

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

Per altri esempi di utilizzo dei parametri filters e listen per applicare filtri della dashboard a singoli elementi della dashboard, consulta Creazione di dashboard LookML.

hidden_fields

Il parametro hidden_fields indica quali campi, se presenti, vengono utilizzati nella query ma sono nascosti nel grafico. Tutti i campi nascosti vengono visualizzati nella sezione della tabella dati di un'esplorazione.

hidden_fields: [inventory_items.count, distribution_centers.id]

query_timezone

Il parametro query_timezone specifica il fuso orario in cui verrà eseguita la query. Le opzioni del fuso orario sono mostrate nella pagina di documentazione Valori per timezone. Se vuoi che la query venga eseguita utilizzando il fuso orario del visualizzatore, puoi assegnare il valore user_timezone.

- name: orders_by_date
  query_timezone: America/Los Angeles

- name: orders_by_customer
  query_timezone: user_timezone

merged_queries

Il parametro merged_queries ti consente di combinare i risultati di più query in un unico elemento della dashboard. Definisci ogni query di origine all'interno del parametro merged_queries dell'elemento e utilizza il parametro secondario join_fields per specificare come devono essere uniti i risultati.

Il seguente codice LookML di esempio crea un elemento di type: looker_grid dei risultati uniti. In questo esempio, il parametro merged_queries viene utilizzato per creare un elemento del dashboard che combina i dati di due query separate in un unico grafico a tabella:

- name: merged_results_element
  title: Merged Results Tile
  type: looker_grid
  merged_queries:
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.count, users.city]
    sorts: [users.count desc 0]
    limit: 5000
    column_limit: 50
    query_timezone: UTC
    listen:
    - State: users.state
  - model: ecommerce
    explore: users
    type: table
    fields: [users.state, users.city]
    sorts: [users.state]
    limit: 500
    column_limit: 50
    query_timezone: UTC
    join_fields:
    - field_name: users.state
      source_field_name: users.state
    - field_name: users.city
      source_field_name: users.city
    listen:
    - State: users.state

In questo esempio, l'elemento del dashboard combina i dati di due query di origine basate sull'esplorazione users nel modello ecommerce. La query principale include i campi users.state, users.count e users.city e ordina i risultati in base al campo users.count. La seconda query di origine include i campi users.state e users.city e ordina i risultati in base al campo users.state.

Il parametro join_field unisce le query di origine in base ai valori corrispondenti nei campi users.state e users.city.

Il parametro listen applica un filtro State a entrambe le query, consentendo agli utenti che visualizzano la dashboard di perfezionare i risultati della query visualizzati nel riquadro della dashboard selezionando uno stato specifico.

Esempio: unione dei dati aziendali

Supponiamo che tu voglia creare una query unita che combini le informazioni sulle aziende di due esplorazioni diverse: company_info e companies. Vuoi unire le query nei campi ipo.stock_symbol, companies.name e companies.contact_email di ogni esplorazione per creare una query che restituisca risultati per nome dell'azienda, email di contatto dell'azienda, anno dell'IPO, simbolo azionario, numero di dipendenti e numero di offerte di lavoro. Puoi definire l'elemento della query unita in LookML nel seguente modo:

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email

Applicare filtri agli elementi della query uniti

L'esempio precedente di un elemento di query unito mostra come applicare filtri hardcoded direttamente all'interno di ogni query di origine utilizzando il parametro filters. Ad esempio, i filtri companies.contact_email: "-NULL" e ipo.valuation_amount: NOT NULL nella query principale limitano i risultati alle aziende che hanno valutazioni ed email di contatto valide. Questi filtri a livello di query prefiltrano i dati prima di unire le query e non possono essere modificati dall'utente.

Puoi anche applicare filtri del dashboard agli elementi della query uniti utilizzando il parametro listen nella definizione di ogni query di origine. Ad esempio, supponiamo di avere un filtro della dashboard denominato Industry che hai definito a livello di dashboard utilizzando il parametro filters per le dashboard LookML:

filters:
- name: Industry
  title: Industry
  type: field_filter
  ui_config:
    type: dropdown_menu
    display: inline
  model: market_research
  explore: company_info
  field: companies.industry

Per applicare il filtro Industry al campo companies.industry in entrambe le query di origine, aggiungi il parametro listen a ciascuna delle definizioni delle query di origine della query unita nel seguente modo:

listen:
  Industry: companies.industry

Ad esempio, il seguente codice campione aggiunge il filtro Industry a entrambe le query di origine nell'elemento dei risultati uniti dell'esempio precedente.

- name: merged_results_element
  title: Merged Results Tile
  merged_queries:
  - model: market_research
    explore: company_info
    fields: [companies.name, companies.contact_email, ipo.public_year, ipo.stock_symbol]
    filters:
      companies.contact_email: "-NULL"
      ipo.valuation_amount: NOT NULL
    sorts: [ipo.public_year desc]
    listen:
      Industry: companies.industry
  - model: company_data
    explore: companies
    fields: [companies.name, ipo.stock_symbol, companies.contact_email,
      companies.number_of_employees, jobs.job_count]
    filters:
      companies.number_of_employees: NOT NULL
      ipo.stock_symbol: "-NULL"
      companies.contact_email: "-NULL"
    sorts: [jobs.job_count desc]
    join_fields:
    - field_name: ipo.stock_symbol
      source_field_name: ipo.stock_symbol
    - field_name: companies.name
      source_field_name: companies.name
    - field_name: companies.contact_email
      source_field_name: companies.contact_email
    listen:
      Industry: companies.industry

Con questa aggiunta, quando un utente interagisce con il filtro della dashboard Industry, la query di origine corrispondente nell'elemento della query unita verrà filtrata di conseguenza.

Parametri della serie

I parametri descritti in questa sezione corrispondono alle opzioni del menu Serie dell'editor di visualizzazioni per i grafici a cascata.

up_color

Imposta il colore delle barre con valori positivi nel grafico. Il valore del colore può essere una stringa esadecimale racchiusa tra virgolette, ad esempio "#2ca6cd", o una stringa di colore denominata CSS, ad esempio mediumblue.

up_color: blue

Il parametro up_color sostituisce il parametro color_application, se utilizzato.

down_color

Imposta il colore delle barre dei valori negativi nel grafico. Il valore del colore può essere una stringa esadecimale racchiusa tra virgolette, ad esempio "#2ca6cd", o una stringa di colore denominata CSS, ad esempio mediumblue.

down_color: "#ff0000"

Il parametro down_color sostituisce il parametro color_application, se utilizzato.

total_color

Imposta il colore della barra del valore totale nel grafico. Il valore del colore può essere una stringa esadecimale racchiusa tra virgolette, ad esempio "#2ca6cd", o una stringa di colore denominata CSS, ad esempio mediumblue.

total_color: yellow

Il parametro total_color sostituisce il parametro color_application, se utilizzato.

color_application

Il parametro color_application e i relativi parametri secondari collection_id e palette_id possono essere utilizzati per applicare una raccolta e una tavolozza di colori specifiche a un elemento del dashboard. Per una panoramica delle raccolte di colori native di Looker, consulta la pagina della documentazione Raccolte di colori.

Se hai l'ID raccolta e l'ID tavolozza per la tavolozza che vuoi utilizzare, puoi inserirli nei sottoparametri collection_id e palette_id. Un ID raccolta o un ID tavolozza può essere un codice alfanumerico o basato sul nome della raccolta di colori. Per le raccolte native di Looker vengono utilizzati codici alfanumerici. Sono specifici dell'istanza e hanno questo aspetto:


color_application:
  collection_id: 1297dk12-86a7-4xe0-8dfc-82de20b3806a
  palette_id: 93c8aeb7-3f8a-4ca7-6fee-88c3617516a1

Le raccolte di colori personalizzate utilizzano ID raccolta e tavolozza basati sul nome della raccolta di colori, che sono portabili tra le istanze e hanno questo aspetto:


color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0

Puoi anche utilizzare la UI per trovare i colori, le raccolte o le tavolozze che preferisci e generare il codice LookML per aggiungerli alla dashboard. Vai a un contenuto definito dall'utente (ad esempio un look, una dashboard o un'esplorazione) e applica i colori, la raccolta o la tavolozza che preferisci alla visualizzazione dei contenuti utilizzando la UI. Una volta fatto, puoi seguire i passaggi per ottenere il LookML della dashboard, copiare il LookML prodotto e incollarlo nella sezione color_application.

color_application e le barre dei valori positivi, negativi e totali

Per impostazione predefinita, il primo colore della tavolozza designata viene applicato alle barre dei valori positivi nel grafico a cascata, il secondo colore della tavolozza viene applicato alle barre negative del grafico a cascata e il terzo colore della tavolozza designata viene applicato alla barra totale del grafico a cascata. Il sottoparametro facoltativo reverse cambia l'applicazione rispettivamente all'ultimo colore, al penultimo colore e al terzultimo colore.

color_application:
  collection_id: blue-tone-collection
  palette_id: blue-tone-collection-categorical-0
  options:
    reverse: true

I parametri up_color, down_color e total_color sostituiscono i colori designati nel parametro color_application, se vengono utilizzati entrambi i tipi di parametri di colore.

Parametri di valore

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

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

label_color

Il parametro label_color accetta un valore di colore per le etichette. Il valore del colore può essere formattato come stringa esadecimale, ad esempio #2ca6cd, o come stringa di colore denominata CSS, ad esempio mediumblue.


label_color: [blue]

Parametri dell'asse X

I parametri descritti in questa sezione corrispondono alle opzioni del menu X dell'editor di visualizzazioni per i grafici a cascata.

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 e equidistanti.
  • time: i dati verranno tracciati in base al tempo 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

show_x_axis_label

Questo parametro determina se l'etichetta dell'asse X viene visualizzata.

show_x_axis_label: true | false

## default value: true

show_x_axis_ticks

Questo parametro determina se i valori vengono visualizzati sull'asse x.

show_x_axis_ticks: true | false

## default value: true

x_axis_zoom

Questo parametro specifica se gli utenti possono ingrandire l'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

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

show_y_axis_labels

Questo parametro determina se l'etichetta dell'asse Y viene visualizzata.

show_y_axis_labels: true | false

## default value: true

show_y_axis_ticks

Questo parametro determina se i valori vengono visualizzati sull'asse y.

show_y_axis_ticks: true | false

## default value: true

y_axis_gridlines

Questo parametro determina se le griglie vengono estese dall'asse Y.

y_axis_gridlines: true | false

## default value: true

y_axis_zoom

Questo parametro specifica se gli utenti possono ingrandire l'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 ingrandire le porzioni più piccole dell'asse Y. Tuttavia, gli utenti potrebbero comunque essere in grado di ingrandire 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

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 Grafico dell'editor di visualizzazioni.

advanced_vis_config

Questo parametro accetta uno snippet JSON HighCharts che esegue l'override di diverse impostazioni di visualizzazione e apre nuove funzionalità. Consulta la pagina della documentazione Personalizzare le visualizzazioni utilizzando l'editor di configurazione dei grafici per esempi di utilizzo di HighCharts JSON 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