Creazione di dashboard LookML

Le dashboard di LookML vengono create dagli sviluppatori di LookML e archiviate come file controllati con versione. Per impostazione predefinita, vengono visualizzati nella cartella dashboard LookML della tua istanza di Looker.

Per confrontare e confrontare le dashboard di LookML e definite dall'utente, consulta la pagina della documentazione relativa al confronto delle dashboard di LookML e definite dall'utente.

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

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

Creazione di un file dashboard di LookML

Per creare una dashboard LookML, inizia creando un file di dashboard con l'estensione .dashboard.lookml, anche se la parte .lookml dell'estensione è silenziosa all'interno dell'IDE. Ecco i passaggi da seguire:

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

  4. Viene visualizzata la finestra Crea file. Nella finestra, assegna un nome al file della dashboard nel campo di scrittura e seleziona Crea.

Modifica dei file della dashboard LookML

Quando crei un file della dashboard di LookML, Looker lo precompila con alcuni 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 sotto il parametro della dashboard elements e 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à di sviluppo.

Esistono diverse opzioni per creare la dashboard:

  • Creazione manuale: puoi creare manualmente una dashboard utilizzando i parametri della dashboard e i parametri degli elementi della dashboard.
  • Copia di una dashboard definita dall'utente: puoi creare una copia di una dashboard definita dall'utente eliminando la dashboard precompilata LookML dal file, copiando la dashboard LookML da una dashboard definita dall'utente e incollandola nel file della dashboard.
  • Copia il codice LookML della dashboard degli 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 relativa creazione. Puoi trovare informazioni e consigli sulla creazione di dashboard con prestazioni elevate nella pagina delle best practice per la creazione di dashboard Looker con prestazioni elevate.

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 che vuoi trasformare in un elemento della dashboard:

  1. Dopo aver creato la query e la visualizzazione che vuoi aggiungere a una dashboard, fai clic sul menu a forma di ingranaggio Esplora azioni.
  2. Seleziona Get LookML per esporre il codice LookML.

  3. Viene visualizzata una finestra Get LookML. Con la Dashboard selezionata nella finestra, seleziona tutto il LookML e copialo.

    Nella parte superiore della finestra Get LookML (Recupera LookML), sono presenti schede per Dashboard, Aggregate Table e Derived Table LookML.

A questo punto, 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 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à 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.

Aggiungere filtri

Una volta salvati gli elementi della dashboard nel file della dashboard, puoi 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 possibili, ad esempio:

  • Regolazione del periodo di tempo visualizzato
  • Modificare la categoria di prodotto, il tipo di cliente specifico e così via
  • Fornire una funzionalità di tipo "ricerca" per 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 sono modificabili dai visualizzatori
  • Filtri per la dashboard, che i visualizzatori della dashboard possono modificare

Filtri impostati come hardcoded negli elementi della dashboard

I filtri impostati come hardcoded negli elementi della dashboard, che gli utenti non possono modificare, di solito vengono creati automaticamente nel passaggio LookML di copia per una visualizzazione o per una dashboard. In una dashboard di LookML, questi filtri utilizzano il parametro degli elementi 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

Puoi creare filtri della dashboard che un utente può modificare in due passaggi:

  1. Crea il filtro della dashboard stesso utilizzando il parametro della dashboard filters e i relativi sottoparametri.
  2. Applica il filtro della dashboard agli elementi della dashboard utilizzando il parametro degli elementi della dashboard listen.

Creazione di un filtro per la dashboard

Il primo passaggio consiste nel creare i filtri con cui gli utenti interagiscono. A tale scopo, aggiungi una sezione filters al file della dashboard, che avrà il seguente aspetto:

- dashboard: dashboard_name
  # possibly some other dashboard parameters here

  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

Le varie opzioni e i parametri di questi filtri sono descritti più in dettaglio nella pagina della documentazione Parametri della dashboard. Una delle cose più importanti da tenere a mente è il tipo di input che ci si aspetta dagli utenti. Puoi assegnare un filtro type al filtro, che accetta un tipo di immissione specifico, ad esempio numeri, date o stringhe. In alternativa, puoi utilizzare il filtro type per associare un filtro a un campo LookML sottostante, nel qual caso Looker selezionerà automaticamente il tipo di input corretto e, se il campo LookML sottostante è type: string, fornirà suggerimenti per i filtri ai visualizzatori della dashboard.

Come descritto nella pagina della documentazione dei parametri della dashboard, solo i filtri con type: field filter utilizzano i parametri explore e field. Se includi i parametri explore e field in qualsiasi altro tipo di filtro, riceverai errori di convalida di LookML.

Applicare un filtro della dashboard agli elementi della dashboard

Una volta creato un filtro della dashboard, dovrai applicarlo agli elementi appropriati utilizzando il parametro listen. L'idea è che l'elemento ascolti uno o più filtri in base all'input utente e si adatti di conseguenza. Questo parametro si applica a tutti i tipi di elementi diversi da type: text e type: button e i dettagli sul suo utilizzo vengono visualizzati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo di come funziona listen, vedi Parametri del grafico ad area per le dashboard di LookML.

Ad esempio, potresti avere un elemento simile al seguente:

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

Puoi notare che questo elemento ha già un parametro filters che limita l'elemento agli ordini approvati (utilizzando il filtro order.status: 'approved'). Questa impostazione non può essere modificata dall'utente.

Supponiamo che tu voglia che l'utente possa filtrare questo elemento utilizzando i filtri della dashboard creati in precedenza in questo esempio. Per farlo, aggiungi un parametro listen come il seguente:

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

Se non vuoi che gli utenti possano modificare la data o la categoria, non aggiungere il parametro listen. Devi solo aggiungere un elemento listen agli elementi che vuoi che l'utente possa modificare.

Vedrai che la sintassi di listen funziona scrivendo il nome del filtro creato e poi il nome del campo a cui vuoi applicare l'input utente.

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 dell'ordine creato (date: order.created_date), mentre un altro lo applica alla data dell'ordine di spedizione (date: order.ship_date):

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

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

Inclusione del file della dashboard in un modello

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

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

include: "*.dashboard.lookml"

Se invece le dashboard LookML appaiono all'interno di una cartella nell'IDE, utilizza il percorso della 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 che vuoi visualizzare in anteprima, fai clic sulla Freccia giù Visualizza le azioni sui file e seleziona Visualizza dashboard.

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

Quando la dashboard è di tuo gradimento, puoi pubblicarla in produzione, consentendo la visualizzazione ad altri utenti con le autorizzazioni corrette. Il metodo per la pubblicazione della dashboard è lo stesso della pubblicazione di altre modifiche a LookML sulla tua istanza e dipende dalle impostazioni di controllo della versione per la tua istanza di Looker.

Cartella dashboard LookML

Dopo la pubblicazione, le dashboard di LookML vengono salvate per impostazione predefinita nella cartella Dashboard LookML. La cartella Dashboard LookML si trova nella cartella Cartelle nel riquadro di navigazione a sinistra. La cartella Dashboard LookML è univoca come diversa dalle altre cartelle in alcuni modi:

  • Devi includere una dashboard LookML in almeno un file del modello perché venga visualizzato nella cartella Dashboard LookML.
  • 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 LookML, devi disporre dell'autorizzazione develop per il modello che include la dashboard LookML.
  • Per eseguire l'esplorazione da qui su un determinato riquadro di una dashboard, i visualizzatori devono disporre dell'autorizzazione explore per il modello su cui si basa il riquadro.
  • Non puoi creare una cartella all'interno della cartella Dashboard LookML.

Spostamento delle dashboard di LookML al di fuori della cartella delle dashboard di LookML

Se hai le autorizzazioni Looker see_lookml_dashboards e develop, nonché l'accesso al modello LookML in cui è inclusa una dashboard LookML, puoi spostare una dashboard LookML in qualsiasi cartella per cui hai il 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 Documentazione e gestione dei contenuti.
  • Nella 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 è attiva la modalità di sviluppo, non puoi spostare le dashboard di LookML al di fuori della cartella Dashboard di LookML. In alternativa, puoi utilizzare l'opzione Importa per copiare la dashboard di LookML come dashboard definita dall'utente in un'altra cartella.

Una cartella che contiene dashboard definite dall'utente e dashboard LookML mostra le dashboard di LookML in una sezione Dashboard LookML. Dalla sezione Dashboard LookML, puoi spostare una dashboard LookML in un'altra cartella o bloccare una dashboard LookML a una lavagna. 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 LookML viene modificato, la dashboard di LookML verrà spostata automaticamente nella cartella Dashboard LookML.

Visualizzazione di LookML per una dashboard LookML esistente

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

Quando selezioni Go to LookML (Vai a LookML), Looker passa al file della dashboard in cui è stata definita la dashboard.

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, eventualmente aggiungendo o sostituendo alcune impostazioni. Se poi modifichi la prima dashboard, la seconda eredita automaticamente quelle modifiche (a meno che non vengano sostituite nella seconda dashboard). Per ulteriori informazioni, consulta la pagina della documentazione Riutilizzare il codice con le estensioni.

Migliorare le prestazioni della dashboard utilizzando l'awareness aggregata

Gli sviluppatori LookML potrebbero essere in grado di migliorare le prestazioni della dashboard LookML utilizzando l'awareness aggregata. Con il riconoscimento degli aggregati, gli sviluppatori possono creare tabelle aggregate sotto i parametri LookML explore, che possono ottimizzare le query per uno o più riquadri in una dashboard.

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

Per ulteriori informazioni, consulta la pagina della documentazione del parametro aggregate_table.