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:
- Attiva la modalità sviluppo.
- Nel menu Sviluppo, vai al tuo progetto.
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.
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:
- Dopo aver creato la query e la visualizzazione che vuoi aggiungere a una dashboard, fai clic sul menu a forma di ingranaggio Esplora azioni.
Seleziona Get LookML per esporre il codice LookML.
Viene visualizzata una finestra Get LookML. Con la Dashboard selezionata nella finestra, seleziona tutto il LookML e copialo.
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:
- Crea il filtro della dashboard stesso utilizzando il parametro della dashboard
filters
e i relativi sottoparametri. - 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 parametriexplore
efield
. Se includi i parametriexplore
efield
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:
- Salva il file
.dashboard.lookml
, facendo clic sul pulsante Salva modifiche nell'angolo in alto a destra del file. - Includi la dashboard nel file del modello pertinente e salva le modifiche apportate al file.
- 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
.