Creazione di dashboard LookML

Le dashboard LookML sono create dagli sviluppatori LookML e archiviate come file con controllo della versione. Per impostazione predefinita, vengono visualizzate nella cartella dashboard LookML dell'istanza di Looker.

Per confrontare le dashboard di LookML con quelle definite dall'utente, consulta la pagina della documentazione Confronto tra dashboard definite dall'utente e LookML.

Per creare una dashboard LookML, devi disporre delle seguenti autorizzazioni di Looker:

• see_lookml_dashboards
• develop

Inoltre, devi avere accesso ai modelli LookML per tutti i dati che vuoi utilizzare nella dashboard.

Creazione di un file della dashboard LookML

Per creare una dashboard LookML, inizia creando un file della dashboard che abbia l'estensione .dashboard.lookml (sebbene la parte .lookml dell'estensione sia silenziosa all'interno dell'IDE). Ecco la procedura da seguire:

1. Attiva la Modalità di sviluppo.
2. Nel menu Sviluppo, vai al progetto.
3. Seleziona l'icona Più del pulsante Aggiungi file o cartella nella parte superiore del riquadro del browser di file nell'IDE di Looker per creare un file della dashboard LookML all'esterno delle cartelle di progetto esistenti. In alternativa, fai clic sul menu Opzioni cartella con tre puntini di una cartella per creare il file all'interno della cartella. Fai clic su Crea dashboard per creare il file della dashboard.

1. Verrà visualizzata la finestra Crea file. Nella finestra, assegna un nome al file della dashboard nel campo di scrittura e seleziona il pulsante Crea.

Modifica dei file delle dashboard LookML

Quando crei un file della dashboard LookML, Looker precompila il file con diversi parametri della dashboard di base, che implementano le impostazioni per l'intera dashboard. Inoltre, precompila il file con diversi parametri degli elementi della dashboard di esempio, che sono raggruppati nel parametro elements della dashboard e che definiscono la funzione e l'aspetto di riquadri, testo e pulsanti della dashboard. Un file .dashboard.lookml appena creato contiene una dashboard LookML simile alla seguente:

- dashboard: order_analysis
  title: Order Analysis
  layout: newspaper
  preferred_viewer: dashboards-next
  tile_size: 100

  filters:

  elements:
    - name: hello_world
      type: looker_column

Puoi modificare il file della dashboard all'interno dell'IDE purché tu sia in modalità sviluppo.

Per la creazione della dashboard sono disponibili diverse opzioni:

• Creazione manuale: puoi creare manualmente una dashboard utilizzando i parametri e i parametri degli elementi della dashboard.
• Copia una dashboard definita dall'utente: puoi creare una copia di una dashboard definita dall'utente eliminando dal file la dashboard precompilata LookML, copiando il LookML della dashboard da una dashboard definita dall'utente e incollandola nel file della dashboard.
• Copia un LookML della dashboard di elementi: puoi copiare il LookML della dashboard da un'esplorazione o da un Look e incollarlo nel file della dashboard.

Quando crei una dashboard, tieni presente le best practice per la creazione della dashboard. Trova informazioni e suggerimenti sulla creazione di dashboard ad alte prestazioni nella pagina Best practice Considerazioni sulla creazione di dashboard di Looker ad alte prestazioni.

Aggiunta di una visualizzazione a una dashboard LookML esistente

Il modo più semplice per aggiungere una visualizzazione a una dashboard LookML esistente è utilizzare la pagina Esplora per creare una query da trasformare in un elemento della dashboard:

1. Dopo aver creato la query e la visualizzazione da aggiungere a una dashboard, fai clic sul menu a forma di ingranaggio Azioni esplorazione dell'esplorazione.

2. Seleziona Ottieni LookML per esporre il codice LookML.

   

3. Viene visualizzata la finestra Ottieni LookML. Con Dashboard selezionata nella finestra, seleziona tutti i LookML e copiali.

   

Da qui, incolla il LookML nel file LookML della tua dashboard. Quando modifichi il file LookML della dashboard, assicurati di:

• Verifica di essere in modalità di sviluppo per poter modificare il file della dashboard.
• Incolla il LookML nel parametro elements della dashboard.
• Utilizza il rientro corretto quando incolli LookML nel file della dashboard. Se possibile, associa il rientro agli elementi esistenti già presenti nel file della dashboard.

Se vuoi, puoi modificare i parametri LookML utilizzando i parametri descritti nelle pagine della documentazione per ogni singolo tipo di elemento.

Aggiungi filtri

Dopo aver salvato gli elementi nel file della dashboard, ti consigliamo di aggiungere filtri, che consentono ai visualizzatori di filtrare alcuni o tutti gli elementi di una dashboard. I filtri possono essere utili per molti possibili motivi, ad esempio:

• Modifica del periodo di tempo visualizzato
• Modifica della categoria di prodotto, del tipo di cliente e così via specifici mostrati
• Offerta di una funzionalità di tipo "ricerca" a un cliente o a un cliente

Assicurati di creare il tipo di filtro che preferisci. I due tipi sono:

• Filtri impostati come hardcoded negli elementi della dashboard, che non possono essere modificati dai visualizzatori
• Filtri della dashboard, che i visualizzatori della dashboard possono modificare

Filtri hardcoded in elementi della dashboard

I filtri hardcoded negli elementi della dashboard e non modificabili dagli utenti di solito vengono creati automaticamente nel passaggio di copia LookML per una visualizzazione o per una dashboard. In una dashboard LookML, questi filtri utilizzano il parametro dell'elemento della dashboard filters e hanno il seguente aspetto:

- name: element_name
  # lots of other element parameters here
  filters:
    dimension_or_measure_name: 'looker filter expression'

Filtri per la dashboard

I filtri della dashboard consentono ai visualizzatori di perfezionare in modo interattivo i dati mostrati negli elementi della dashboard. Per creare un filtro nella dashboard:

1. Crea il filtro della dashboard utilizzando il parametro filters nel file della dashboard LookML.
2. Applica il filtro ai singoli elementi della dashboard utilizzando il parametro listen.

Creazione di un filtro della dashboard

Il parametro filters consente di creare vari tipi di filtri interattivi per la dashboard.

Per creare un filtro della dashboard con cui gli utenti possono interagire, aggiungi un parametro filters al file della dashboard. Ad esempio, il seguente codice campione crea una dashboard LookML con i filtri date e category_name:

- dashboard: dashboard_name
  title: Dashboard Title
  layout: newspaper
  filters:
  - name: date
    title: 'Date Range'
    type: date_filter
    default_value: 30 days

  - name: category_name
    type: field_filter
    model: ecommerce
    explore: product
    field: category.name

Il codice nell'esempio precedente crea i seguenti filtri:

• date: un filtro per data che consente agli utenti di selezionare un intervallo di date. Il valore predefinito è impostato sugli ultimi 30 giorni.
• category_name: un filtro di campo che consente agli utenti di filtrare in base alla categoria di prodotto. Questo filtro genera dinamicamente opzioni basate sul campo category.name all'interno del modello LookML (ecommerce) e dell'esplorazione (product) specificati.

Nota: solo i filtri con type: field_filter utilizzano i parametri explore e field. Se includi i parametri explore e field con qualsiasi altro tipo di filtro, riceverai errori di convalida LookML.

Applicazione di un filtro della dashboard agli elementi della dashboard

Una volta creato un filtro della dashboard, puoi applicarlo a singoli elementi della dashboard utilizzando il parametro listen. L'utilizzo del parametro listen in questo modo consente di aggiornare dinamicamente gli elementi collegati in base alla selezione dell'utente nel filtro.

Nota: il parametro listen è supportato da tutti i tipi di elementi tranne type: text e type: button.

Considera ad esempio il seguente codice LookML di esempio per un elemento del grafico ad area:

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'

Il grafico approved_orders_by_day mostra il conteggio degli ordini approvati per giorno, poiché la query si basa sulla dimensione orders_created_date e sulla misura orders.count e ha un filtro applicato, orders.status: 'approved'. Questo filtro è fisso all'interno dell'elemento e non può essere modificato dai visualizzatori della dashboard.

Per consentire agli utenti di filtrare il grafico approved_orders_by_day utilizzando il filtro date e il filtro category_name dell'esempio precedente, aggiungi il parametro listen all'elemento della dashboard.

- name: approved_orders_by_day
  type: looker_area
  model: ecommerce
  explore: orders
  dimensions: [orders.created_date]
  measures: [orders.count]
  filters:
    orders.status: 'approved'
  listen:
    category_name: category.name
    date: orders.created_date

Quando un visualizzatore della dashboard interagisce con il filtro category_name o date, il grafico approved_orders_by_day viene aggiornato automaticamente per riflettere i risultati filtrati.

Il parametro listen utilizza la sintassi filter_name: field_name. Nell'esempio precedente, category_name e date sono i nomi dei filtri, mentre category.name e orders.created_date sono i campi che verranno utilizzati per consentire ai visualizzatori della dashboard di fornire input per il filtro.

Un filtro della dashboard può essere applicato a qualsiasi campo (dello stesso tipo di dati) in qualsiasi elemento. Ad esempio, un elemento può applicare l'input di un utente alla data di creazione dell'ordine (date: orders.created_date), mentre un altro può applicarlo alla data di spedizione dell'ordine (date: orders.ship_date):

- name: element_one
  # lots of other element parameters here
  listen:
    date: orders.created_date

- name: element_two
  # lots of other element parameters here
  listen:
    date: orders.ship_date

Nota: per gli elementi della dashboard che utilizzano il parametro merged_queries, ogni query di origine può rimanere in ascolto di uno o più filtri della dashboard. Puoi definire la logica di filtro per ogni query di origine in modo indipendente, a prescindere dal numero di query di origine nell'elemento dei risultati unito. Se una query non ha un parametro listen, non sarà interessata dai filtri della dashboard.

Inclusione del file della dashboard in un modello

Affinché la tua dashboard sia visibile per l'anteprima in modalità di sviluppo o visibile in produzione, deve essere inclusa nel file del modello su cui si basa utilizzando un'istruzione include.

Una pratica comune è includere tutte le dashboard LookML in un modello utilizzando un carattere jolly:

include: "*.dashboard.lookml"

oppure, se le tue dashboard LookML vengono visualizzate all'interno di una cartella nell'IDE, utilizza il percorso della loro posizione

 include: "/path/*.dashboard.lookml"

Puoi anche includere una dashboard specifica specificando il nome file:

include: "my_dashboard.dashboard.lookml"

Salvataggio, anteprima e pubblicazione della dashboard LookML

Per visualizzare l'anteprima della dashboard:

1. Salva il file .dashboard.lookml facendo clic sul pulsante Salva modifiche nell'angolo in alto a destra del file.
2. Includi la dashboard nel file del modello pertinente e salva le modifiche apportate al file.
3. Nel file .dashboard.lookml di cui vuoi visualizzare l'anteprima, fai clic sull'icona Freccia giù Visualizza le azioni sul file e seleziona Visualizza dashboard.

Puoi apportare ulteriori modifiche al tuo file .dashboard.lookml, salvarle e visualizzare di nuovo l'anteprima della dashboard.

Se la dashboard ti soddisfa, puoi pubblicarla in produzione, in modo da consentire agli altri utenti che dispongono delle autorizzazioni corrette di visualizzarla. Il metodo per pubblicare la dashboard è lo stesso di pubblicazione di altre modifiche in LookML nell'istanza e dipende dalle impostazioni di controllo della versione per la tua istanza di Looker.

Cartella delle dashboard LookML

Una volta pubblicate, le dashboard LookML vengono salvate per impostazione predefinita nella cartella delle dashboard di LookML. La cartella Dashboard LookML si trova nella cartella Cartelle nella barra di navigazione a sinistra. La cartella dashboard LookML è univoca rispetto alle altre cartelle per diversi modi:

• Devi includere una dashboard LookML in almeno un file del modello affinché venga visualizzata nella cartella dashboard di LookML.
• Per visualizzare la cartella delle dashboard di LookML, gli utenti devono disporre dell'autorizzazione see_lookml_dashboards.
• Per visualizzare le dashboard all'interno della cartella dashboard di LookML, gli utenti devono avere accesso al modello LookML che include la dashboard.
• Per visualizzare un determinato riquadro all'interno di una dashboard LookML, i visualizzatori della dashboard devono avere accesso al modello LookML su cui è basato il riquadro.
• Per modificare una dashboard nella cartella Dashboard LookML, devi disporre dell'autorizzazione develop per il modello che include la dashboard LookML.
• Per Esplorare da qui su un determinato riquadro all'interno di una dashboard, i visualizzatori della dashboard devono disporre dell'autorizzazione explore per il modello su cui si basa il riquadro.
• Non puoi creare una cartella all'interno della cartella delle dashboard di LookML.

Spostamento delle dashboard LookML all'esterno della cartella delle dashboard di LookML

Se disponi delle autorizzazioni Looker see_lookml_dashboards e develop e dell'accesso al modello LookML in cui è inclusa una dashboard LookML, puoi spostare una dashboard LookML in qualsiasi cartella per cui disponi del livello di accesso Gestisci accesso, modifica.

Esistono due modi per spostare la dashboard:

• Dalla cartella Dashboard LookML, seleziona la dashboard da spostare, fai clic sul pulsante Sposta nella parte superiore della sezione delle dashboard e seleziona la cartella in cui vuoi spostare la dashboard. Per ulteriori informazioni, consulta la pagina della documentazione Organizzazione e gestione dei contenuti.
• Dalla cartella Dashboard LookML, fai clic sul menu con tre puntini per la dashboard, seleziona Sposta dal menu e seleziona la cartella in cui vuoi spostare la dashboard.

Se sei in modalità di sviluppo, non puoi spostare le dashboard LookML all'esterno della cartella dashboard di LookML. Puoi utilizzare l'opzione Importa per copiare la dashboard LookML come dashboard definita dall'utente in un'altra cartella.

Una cartella che contiene sia dashboard definite dall'utente sia dashboard LookML mostra le dashboard LookML in una sezione Dashboard LookML. Dalla sezione Dashboard LookML, puoi spostare una dashboard LookML in un'altra cartella o fissare una dashboard LookML a una lavagna. Tuttavia, a differenza delle dashboard definite dall'utente, le dashboard LookML non possono essere rinominate o spostate nel cestino da una cartella.

Se il valore del parametro dashboard di una dashboard LookML viene modificato, la dashboard LookML verrà spostata automaticamente nella cartella delle dashboard di LookML.

Visualizzazione del codice LookML per una dashboard LookML esistente

Se disponi dell'autorizzazione see_lookml, puoi accedere alla dashboard LookML per una dashboard LookML esistente selezionando Vai a LookML dal menu con tre puntini Azioni della dashboard di una dashboard:

Quando selezioni Vai a LookML, Looker accede al file della dashboard in cui è definita la dashboard LookML.

Estensione di una dashboard LookML

Dopo aver creato una dashboard LookML, puoi estenderla. In questo modo puoi creare una seconda dashboard basata su quella originale, aggiungendo o sostituendo alcune impostazioni. Se poi modifichi la prima dashboard, la seconda eredita automaticamente le modifiche (a meno che non venga ignorata nella seconda). Per saperne di più, consulta la pagina della documentazione Riutilizzo del codice con estensioni.

Migliorare le prestazioni della dashboard tramite il riconoscimento degli aggregati

Gli sviluppatori di LookML possono essere in grado di migliorare le prestazioni della dashboard di LookML utilizzando il rilevamento dei dati aggregati. Grazie agli aggregati, gli sviluppatori possono creare tabelle aggregate nei parametri explore di LookML, in modo da ottimizzare le query per uno o più riquadri in una dashboard.

Dopo aver creato e visualizzato una dashboard LookML, puoi utilizzare l'opzione Ottieni LookML della tabella aggregata nel menu con tre puntini Azioni dashboard, visibile se disponi dell'autorizzazione see_lookml.

Per saperne di più, consulta la pagina della documentazione relativa al parametro aggregate_table.

Nota: puoi trovare altre informazioni e consigli sulla creazione di dashboard con un rendimento elevato nella pagina delle best practice Considerazioni per la creazione di dashboard di Looker ad alte prestazioni.