Creazione di dashboard LookML

Le dashboard di LookML vengono create dagli sviluppatori di LookML e archiviate come file con controllo delle versioni. Per impostazione predefinita, vengono visualizzate nella cartella Dashboard LookML della tua 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ù Aggiungi file o cartella nella parte superiore del riquadro del browser dei file nell'IDE di Looker per creare un file della dashboard LookML al di fuori delle cartelle del 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 della dashboard LookML

Quando crei un file della dashboard di LookML, Looker lo precompila con diversi parametri di dashboard di base, che implementano le impostazioni per l'intera dashboard. Inoltre, precompila il file con diversi parametri degli elementi della dashboard di esempio, raggruppati nel parametro della dashboard elements, che definiscono la funzione e l'aspetto dei riquadri, del testo e dei 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.

Hai a disposizione diverse opzioni per creare la tua dashboard:

• 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 il codice LookML della dashboard precompilato dal file, copiando il codice LookML della dashboard da una dashboard definita dall'utente e incollandolo nel file della dashboard.
• Copia il codice LookML della dashboard degli elementi: puoi copiare il codice 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 sua creazione. 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 codice LookML nel file LookML della 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 di documentazione per ogni singolo tipo di elemento.

Aggiungi filtri

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

• Modificare il periodo di tempo visualizzato
• Modifica della categoria di prodotto, del tipo di cliente e così via specifici mostrati
• Fornire una funzionalità di tipo "lookup" per un cliente o un account 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 negli elementi della dashboard

I filtri che inserisci in modo hard-coded negli elementi della dashboard, che gli utenti non possono modificare, vengono solitamente creati automaticamente nel passaggio di copia di LookML per una visualizzazione o per una dashboard. In una dashboard LookML, questi filtri utilizzano il parametro dell'elemento 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 visualizzati 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 ti consente di creare vari tipi di filtri interattivi per la tua 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 di esempio 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 di 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.

Ad esempio, considera il seguente codice LookML di esempio per un elemento del grafico a aree:

- 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 dagli utenti che visualizzano la dashboard.

Per consentire agli utenti di filtrare il grafico approved_orders_by_day utilizzando i filtri date e 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 con il filtro date, il grafico approved_orders_by_day viene aggiornato automaticamente in base ai 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 al filtro.

Un filtro della dashboard può essere applicato a qualsiasi campo (dello stesso tipo di dati) in un determinato 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ò ascoltare 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 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 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 l'istanza di Looker.

Cartella delle dashboard LookML

Una volta pubblicate, le dashboard LookML vengono salvate per impostazione predefinita nella cartella dashboard di LookML. La cartella Dashboard LookML si trova nella cartella Cartelle nella barra di navigazione a sinistra. La cartella Dashboard di LookML è diversa dalle altre cartelle in alcuni modi:

• Per visualizzare una dashboard di LookML nella cartella Dashboard di LookML, devi includerla in almeno un file modello.
• Per visualizzare la cartella Dashboard LookML, gli utenti devono disporre dell'autorizzazione see_lookml_dashboards.
• Per visualizzare le dashboard all'interno della cartella Dashboard LookML, gli utenti devono disporre dell'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 si basa il riquadro.
• Per modificare una dashboard nella cartella Dashboard di LookML, devi disporre dell'autorizzazione develop per il modello che include la dashboard di LookML.
• Per esplorare da qui in 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 Dashboard di LookML.

Spostare le dashboard di LookML al di fuori della cartella delle dashboard di LookML

Se disponi delle autorizzazioni Looker see_lookml_dashboards e develop, nonché dell'accesso al modello LookML in cui è inclusa una dashboard LookML, puoi spostare una dashboard LookML in qualsiasi cartella per la quale 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 relativa all'organizzazione e alla gestione dei contenuti.
• Nella cartella Dashboard di LookML, fai clic sul menu con tre puntini della 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. In alternativa, 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 di LookML viene modificato, la dashboard di LookML tornerà automaticamente nella cartella 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 passa al file della dashboard in cui è definita la dashboard di LookML.

Estensione di una dashboard LookML

Dopo aver creato una dashboard di LookML, puoi estenderla. In questo modo puoi creare una seconda dashboard basata su quella originale, eventualmente 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 ulteriori informazioni, consulta la pagina della documentazione Riutilizzo del codice con extends.

Migliorare le prestazioni della dashboard utilizzando la notorietà aggregata

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, che possono ottimizzare le query per uno o più riquadri in una dashboard.

Dopo aver creato e visualizzato una dashboard di LookML, puoi utilizzare l'opzione Recupero del 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: nella pagina Best practice Considerazioni per la creazione di dashboard di Looker efficaci puoi trovare altre informazioni e consigli sulla creazione di dashboard efficaci.