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 LookML e quelle definite dall'utente, consulta la pagina della documentazione Confronto tra dashboard definite dall'utente e dashboard 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 con l'estensione .dashboard.lookml (anche se la parte .lookml dell'estensione non è visibile nell'IDE). I passaggi da seguire sono i seguenti:

1. Attiva la modalità di sviluppo.
2. Nel menu Sviluppa, 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 con tre puntini Opzioni cartella di una cartella per creare il file all'interno della cartella. Fai clic su Crea dashboard per creare il file della dashboard.

1. Viene 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 il codice LookML della dashboard simile al 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 se sei in modalità di sviluppo.

Hai a disposizione diverse opzioni per creare la tua dashboard:

• Creazione manuale:puoi creare manualmente una dashboard utilizzando i parametri della dashboard 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 consigli per creare dashboard ad alte prestazioni nella pagina Best practice Considerazioni per la 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 selezionato nella finestra, seleziona tutto il codice LookML e copialo.

   

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 codice LookML sotto il parametro elements della dashboard.
• Utilizza l'indentazione corretta quando incolli il codice LookML nel file della dashboard. Se possibile, abbina la rientranza 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 motivi, ad esempio:

• Modificare il periodo di tempo visualizzato
• Modifica della categoria di prodotto, del tipo di cliente e così via specifica da mostrare
• 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 codificati negli elementi della dashboard che non possono essere modificati dai visualizzatori della dashboard
• 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 della dashboard:

1. Crea il filtro della dashboard utilizzando il parametro filters all'interno del 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 data che consente agli utenti di selezionare un intervallo di date. Il valore predefinito è impostato sugli ultimi 30 giorni.
• category_name: un filtro dei campi 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

Dopo aver creato un filtro della dashboard, puoi applicarlo ai 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, ad eccezione di 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 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 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 lo applica 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 indipendentemente dal numero di query di origine nell'elemento dei risultati uniti. 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 dashboard sia visibile in anteprima in modalità di sviluppo o 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"

In alternativa, se le dashboard LookML vengono visualizzate in una cartella nell'IDE, utilizza il percorso della relativa posizione

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

Puoi anche includere una dashboard specifica specificandone il nome file:

include: "my_dashboard.dashboard.lookml"

Salvare, visualizzare l'anteprima e pubblicare la 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 a forma di freccia giù Visualizza azioni file e seleziona Visualizza dashboard.

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

Una volta che la dashboard è pronta, puoi pubblicarla in produzione, in modo che possa essere visualizzata da altri utenti con le autorizzazioni corrette. Il metodo per pubblicare la dashboard è lo stesso utilizzato per pubblicare altre modifiche a LookML nella tua istanza e dipende dalle impostazioni di controllo della versione per l'istanza di Looker.

Cartella delle dashboard LookML

Una volta pubblicate, le dashboard di LookML vengono salvate nella cartella Dashboard di LookML per impostazione predefinita. La cartella Dashboard di LookML si trova nella cartella Cartelle nel riquadro 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 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 di LookML, puoi spostare una dashboard di questo tipo in qualsiasi cartella per cui disponi del livello di accesso Gestisci accesso, modifica.

Esistono due modi per spostare la dashboard:

• Nella cartella Dashboard di 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 spostarla. Per ulteriori informazioni, consulta la pagina della documentazione relativa all'organizzazione e alla gestione dei contenuti.
• Nella cartella Dashboard 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 di 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 di LookML mostra le dashboard di LookML in una sezione Dashboard di LookML. Dalla sezione Dashboard di LookML, puoi spostare una dashboard di LookML in un'altra cartella o fissarla in una bacheca. Tuttavia, a differenza delle dashboard definite dall'utente, le dashboard di 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 di una dashboard LookML esistente

Se disponi dell'autorizzazione see_lookml, puoi accedere al codice LookML di una dashboard di LookML esistente selezionando Vai a LookML dal menu Azioni dashboard con tre puntini 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 modifichi la prima dashboard, la seconda eredita automaticamente le modifiche (a meno che non vengano sostituite nella seconda dashboard). Per ulteriori informazioni, consulta la pagina della documentazione Riutilizzo del codice con extends.

Migliorare le prestazioni della dashboard utilizzando la notorietà aggregata

Gli sviluppatori LookML potrebbero essere in grado di migliorare le prestazioni delle dashboard di LookML utilizzando il riconoscimento degli aggregati. Con il riconoscimento degli aggregati, gli sviluppatori possono creare tabelle aggregate sotto i 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 ulteriori informazioni, consulta la pagina della documentazione del parametro aggregate_table.

Nota: per altre informazioni e consigli sulla creazione di dashboard efficaci, consulta la pagina Best practice Considerazioni per la creazione di dashboard di Looker efficaci.