Tieni presente che stai visualizzando la documentazione di Looker. Per la documentazione di Looker Studio, visita https://support.google.com/looker-studio.

Questa pagina è stata tradotta dall'API Cloud Translation.

Creazione di dashboard LookML

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

Per confrontare le dashboard LookML e quelle definite dall'utente, consulta la pagina della documentazione Confrontare le dashboard LookML e quelle definite dall'utente.

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

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

Creazione di un file della dashboard LookML in corso...

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). Per farlo, segui questi passaggi:

Attiva Modalità di sviluppo.
Nel menu Sviluppo, vai al tuo progetto.
Seleziona l'icona più 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 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.
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 delle dashboard LookML

Quando crei un file di dashboard LookML, Looker lo compila automaticamente con diversi parametri della dashboard di base, che implementano le impostazioni per l'intera dashboard. Inoltre, il file viene precompilato con diversi parametri degli elementi della dashboard di esempio, che sono raggruppati nel parametro della dashboard elements e 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 a questo:

- 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 come preferisci, purché tu sia in modalità di sviluppo.

Esistono diverse opzioni per creare la 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 dal file il codice LookML della dashboard precompilata, copiando la dashboard LookML da una dashboard definita dall'utente e incollandola nel file della dashboard.
Copia il LookML della dashboard degli elementi: puoi copiare il LookML della dashboard da un'esplorazione o un Look e incollarlo nel file della dashboard.

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

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:

Dopo aver creato la query e la visualizzazione che vuoi aggiungere a una dashboard, fai clic sul menu a forma di ingranaggio Esplora azioni dell'esplorazione.
Seleziona Ottieni LookML per esporre LookML.
Viene visualizzata la finestra Ottieni LookML. Con Dashboard selezionata 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 LookML sotto il parametro elements della dashboard.
Utilizza il rientro corretto quando incolli LookML nel file della dashboard. Se possibile, abbina 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 della dashboard nel file della dashboard, puoi aggiungere dei 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 mostrato
Modificare la categoria di prodotto specifica, il tipo di cliente ecc. mostrati
Fornire una funzionalità di tipo "ricerca" per un cliente

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

Filtri impostati come hardcoded negli elementi della dashboard, che i visualizzatori della dashboard non possono modificare
Filtri della dashboard che i visualizzatori 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, in genere vengono creati automaticamente nel passaggio della copia di 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

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

Crea il filtro della dashboard utilizzando il parametro della dashboard filters e i relativi sottoparametri.
Applica il filtro della dashboard agli elementi della dashboard utilizzando il parametro dell'elemento della dashboard listen.

Creazione di un filtro della dashboard

Il primo passaggio consiste nel creare i filtri con cui gli utenti interagiscono. Per farlo, aggiungi al file della dashboard una sezione filters, che avrà un aspetto simile al seguente:

- 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 per questi filtri sono descritti in maggiore dettaglio nella pagina della documentazione Parametri della dashboard. Uno degli aspetti più importanti da tenere a mente è il tipo di input che ti aspetti dagli utenti. Puoi assegnare un elemento type al filtro, in modo che accetti un tipo specifico di input, come 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 sui filtri ai visualizzatori delle dashboard.

Come descritto nella pagina della documentazione Parametri della dashboard, 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 nella dashboard, dovrai applicarlo agli elementi appropriati utilizzando il parametro listen. L'idea è che l'elemento "ascolta" uno o più filtri per l'input utente'utente e si adatti di conseguenza. Questo parametro si applica a tutti i tipi di elementi, eccetto type: text e type: button. I dettagli sul relativo utilizzo sono riportati nelle pagine della documentazione per ogni singolo tipo di visualizzazione. Per un esempio rappresentativo di come funziona listen, consulta Parametri dei grafici ad area per le dashboard 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 (mediante il filtro order.status: 'approved'). Questo non può essere modificato dall'utente.

Supponi di volere che l'utente possa filtrare questo elemento utilizzando i filtri della dashboard creati in precedenza in questo esempio. A questo scopo, 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 listen funziona scrivendo prima il nome del filtro che hai creato e poi scrivendo 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 qualsiasi elemento. Ad esempio, un elemento può applicare l'input di un utente alla data di creazione dell'ordine (date: order.created_date), mentre un altro la applica alla data di spedizione dell'ordine (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 tua dashboard sia visibile per l'anteprima in modalità di sviluppo o in produzione, deve essere inclusa nel file del modello su cui si basa la dashboard 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 dashboard LookML vengono visualizzate all'interno di una cartella nell'IDE, utilizza il percorso della relativa 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 di cui vuoi visualizzare l'anteprima, fai clic sull'icona 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.

Quando la dashboard ti soddisfa, puoi pubblicarla in produzione, in modo che altri utenti con le autorizzazioni corrette possano vederla. Il metodo per pubblicare la dashboard è uguale alla pubblicazione di altre modifiche a LookML sull'istanza e dipende dalle impostazioni di controllo della versione per la tua istanza Looker.

Cartella delle dashboard LookML

Una volta pubblicate, le dashboard LookML vengono salvate nella cartella dashboard LookML per impostazione predefinita. La cartella dashboard LookML si trova nella cartella Cartelle nel riquadro 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 perché venga visualizzata 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 avere accesso al modello LookML che include la dashboard.
Per visualizzare un determinato riquadro all'interno di una dashboard LookML, i visualizzatori delle 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 sul modello che include la dashboard LookML.
Per utilizzare Esplora 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 LookML.

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

Se hai le autorizzazioni Looker see_lookml_dashboards e develop e l'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 alla cartella Gestione dell'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.
Nella cartella Dashboard LookML, fai clic sul menu con tre puntini della dashboard, seleziona Sposta dal menu e la cartella in cui vuoi spostare la dashboard.

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

Una cartella contenente 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 bloccarne una su una bacheca. 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 Dashboard LookML.

Visualizzazione di 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 LookML.

Estensione di una dashboard LookML

Dopo aver creato una dashboard LookML, puoi estenderla. Ciò consente di creare una seconda dashboard basata su quella originale, eventualmente aggiungendo o sostituendo alcune impostazioni. Se cambi la prima dashboard, la seconda eredita automaticamente le modifiche (a meno che non venga sostituita nella seconda dashboard). Per ulteriori informazioni, consulta la pagina della documentazione relativa al riutilizzo del codice con estensioni.

Migliorare il rendimento della dashboard utilizzando il riconoscimento aggregato

Gli sviluppatori LookML possono migliorare le prestazioni della dashboard LookML utilizzando il consapevolezza dell'aggregazione. Con il riconoscimento dell'aggregazione, gli sviluppatori possono creare tabelle aggregate sotto i parametri explore LookML, 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 LookML della tabella aggregata nel menu con tre puntini Azioni della dashboard, visibile se disponi dell'autorizzazione see_lookml.

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