Utilizzare il diagramma LookML

Il diagramma di LookML è un'estensione, un'applicazione web creata utilizzando i componenti di Looker, sviluppata utilizzando il framework di estensioni di Looker e di cui è stato eseguito il deployment tramite il marketplace di Looker.

Il diagramma LookML è un diagramma entità-relazione di un modello LookML che mostra visivamente le relazioni tra i suoi oggetti LookML. Utilizza questa estensione per:

  • Valutare la struttura del modello LookML, identificare le aree in cui il LookML può essere consolidato e determinare il modo migliore per aggiungere elementi al modello
  • Identifica la logica errata, riducendo le probabilità di calcoli errati e prestazioni scadenti delle query
  • Scopri come eseguire la modellazione dei dati basata su codice (LookML)

Questa pagina di documentazione descrive come utilizzare il diagramma LookML versione 2.0.0 e successive. Gli amministratori di Looker devono consultare la pagina della documentazione Configurazione dell'estensione Diagramma di LookML per istruzioni su come attivare questa estensione per gli utenti di Looker.

Questa pagina spiega come:

Dopo aver installato il diagramma di LookML, puoi accedervi facendo clic su Blocchi nel pannello di navigazione a sinistra e selezionando il riquadro Diagramma di LookML.

Osservare le relazioni tra gli oggetti LookML con il diagramma LookML

L'amministratore di Looker deve concederti le autorizzazioni per il modello lookml_diagram e per qualsiasi altro modello che vuoi visualizzare nell'estensione.

L'estensione LookML Diagram è costituita dai seguenti elementi:

  1. Un riquadro Impostazioni diagramma per selezionare un modello, un ramo Git e un'esplorazione
  2. Un riquadro Opzioni di visualizzazione per perfezionare i campi da visualizzare
  3. Una sezione Guida al diagramma per fornire una spiegazione aggiuntiva degli elementi del diagramma
  4. Un canvas del diagramma per interagire con gli oggetti LookML nell'esplorazione selezionata
  5. Elenco dei campi di un'esplorazione selezionata, raggruppati per visualizzazione
  6. Una barra degli strumenti con opzioni di zoom e posizione e un'icona per mostrare o nascondere la minimappa del canvas, che consente di orientarsi all'interno di un diagramma più grande
  7. Un profiler di oggetti per visualizzare informazioni sull'oggetto LookML e passare al relativo LookML o all'esplorazione associata, se applicabile

Fai doppio clic sull'icona Impostazioni diagramma o su quella Opzioni di visualizzazione per comprimere il riquadro a sinistra.

Configurazione delle impostazioni del diagramma

Fai clic sull'icona del diagramma nella barra di navigazione del diagramma per visualizzare Impostazioni diagramma.

Il menu a discesa Scegli un modello elenca tutti i modelli per cui disponi delle autorizzazioni di visualizzazione. Dopo aver selezionato un modello, vengono visualizzate altre due opzioni:

  • Il menu a discesa Ramo corrente viene compilato con un elenco dei rami Git del modello. Se il modello ha un solo ramo, in genere il ramo di produzione, viene visualizzato questo ramo. Se sei in modalità di produzione o se non disponi delle autorizzazioni per modificare i rami Git, il menu a discesa Ramo corrente è disattivato.

    Se l'amministratore ti ha concesso le autorizzazioni per modificare i rami Git nel diagramma LookML, attiva la modalità di sviluppo, assicurati che siano selezionati sia un modello sia un'esplorazione e poi seleziona un ramo per visualizzare il diagramma in base alla configurazione del modello in quel ramo.

  • L'elenco Seleziona un'esplorazione viene compilato con un elenco delle esplorazioni del modello. Fai clic sul nome di un'esplorazione per visualizzarne i campi, raggruppati per visualizzazione, nel riquadro della pagina.

Esplorare le opzioni di visualizzazione

Con un'esplorazione selezionata, puoi utilizzare il riquadro Opzioni di visualizzazione per limitare i campi e le visualizzazioni visualizzati nel canvas.

Limitare i campi visualizzati

Puoi scegliere di visualizzare tutti i campi in ogni visualizzazione dell'esplorazione selezionando Tutti i campi in Campi da visualizzare oppure, per mostrare solo le visualizzazioni con campi uniti ad altri campi, seleziona Campi con unioni.

Se è attivata, l'opzione di attivazione/disattivazione Nascondi campi nascosti nasconde tutti i campi che contengono hidden: yes nel LookML sottostante. L'opzione di attivazione/disattivazione Nascondi campi nascosti è attiva per impostazione predefinita.

Limitare le visualizzazioni visualizzate

La sezione Visualizzazioni del riquadro Opzioni di visualizzazione mostra un elenco delle visualizzazioni presenti nell'esplorazione selezionata. Per impostazione predefinita, tutte le visualizzazioni vengono visualizzate nella tela del diagramma. Quando nascondi una vista, l'oggetto vista e le eventuali unioni che lo collegano ad altri oggetti nell'esplorazione vengono nascosti nel riquadro del diagramma.

Fai clic su Nascondi tutto per nascondere tutte le visualizzazioni nell'esplorazione dal riquadro del diagramma. Fai clic su Mostra tutte per mostrare tutte le visualizzazioni nell'esplorazione.

Puoi anche nascondere in modo selettivo le singole visualizzazioni dal riquadro deselezionando l'icona a forma di occhio a destra del nome della visualizzazione. Quando la visualizzazione è nascosta, il nome della visualizzazione non è selezionabile e l'icona a forma di occhio è barrata. Per mostrare una singola visualizzazione nascosta, fai clic sull'icona dell'occhio barrato.

Interpretazione del canvas del diagramma

Nel riquadro del diagramma LookML sono rappresentate tutte le entità e le relazioni di una determinata esplorazione. In termini di Looker, puoi considerare il diagramma di LookML come una rappresentazione di come gli oggetti LookML vengono uniti in un'esplorazione per un determinato modello.

La barra del titolo dell'oggetto nella parte superiore del riquadro mostra il nome dell'esplorazione di cui vengono visualizzate le visualizzazioni nel riquadro. Fai clic sull'icona delle informazioni sull'esplorazione, un "i" racchiuso in un cerchio, nella barra del titolo dell'oggetto per aprire lo strumento Profiler oggetti e scoprire di più sull'esplorazione selezionata. Fai clic sulla freccia in senso orario per ricaricare l'estensione.

Entità

Ogni vista dell'esplorazione è rappresentata come un proprio insieme di entità, con il nome della vista visualizzato nella parte superiore dell'insieme:

  1. La visualizzazione di base di Esplora è indicata da uno sfondo blu scuro.
  2. Le visualizzazioni unite in Esplora hanno uno sfondo azzurro chiaro.
  3. Quando un join, una visualizzazione o un campo è selezionato, viene evidenziato in blu brillante.

    Sotto ogni visualizzazione è riportato un elenco dei campi appartenenti a quella visualizzazione:

  4. Le dimensioni sono elencate in alto.

  5. Le misure sono elencate in basso ed evidenziate in arancione chiaro.

  6. Se il campo è una chiave primaria, a destra del nome del campo viene visualizzata un'icona a forma di chiave.

A sinistra di ogni campo è presente un'icona che ne indica il tipo:

  • A: dimensioni di type: string
  • #: dimensioni o misure di type: number
  • Barre a più livelli: dimensioni di type: tier
  • Spunta: dimensioni di type: yesno
  • Calendar: dimensioni di type: date, type: date_time, type: time
  • Punto mappa: dimensioni di type: location, type: distance, type: zipcode

Fai clic sul nome del campo per aprire lo strumento Profiler oggetti e scoprire di più sul campo selezionato.

Relazioni

Il diagramma utilizza una linea per rappresentare la relazione tra ogni oggetto e gli altri oggetti nel modello selezionato. La forma della linea, dove si attacca alla visualizzazione o al campo, indica la cardinalità della relazione tra i due oggetti; una linea biforcata indica una cardinalità "molti" e una singola linea indica una cardinalità "uno". La relazione viene letta come da la visualizzazione di base a la visualizzazione unita. Ad esempio:

  1. Un join uno a uno da order_items a inventory_items, con join sul campo id
  2. Un'unione molti-a-uno da order_items a repeat_purchase_facts

Puoi anche passare il mouse sopra la linea per vedere quale tipo di join collega i due oggetti.

Fai clic sulla riga per aprire lo strumento Profiler oggetti e visualizzare ulteriori informazioni sull'unione.

Opzioni di visualizzazione di Canvas

Una mini mappa in alto a destra nel riquadro può aiutarti a orientarti all'interno di diagrammi più grandi. La parte disattivata della mappa indica la parte del diagramma attualmente visualizzata nel riquadro. Fai clic e trascina lo spazio vuoto nell'area di disegno per spostarti in altre parti del diagramma.

Una barra degli strumenti verticale in basso a sinistra del riquadro contiene le icone per controllare la visualizzazione del diagramma:

  • Fai clic su (+) per aumentare lo zoom e su (-) per diminuirlo.
  • Fai clic sull'icona quadrata per tornare alla posizione iniziale predefinita del diagramma.
  • Fai clic sull'icona della mappa per attivare o disattivare la mini mappa.

Visualizzazione delle informazioni sugli oggetti con il profiler degli oggetti

Lo strumento di profilazione degli oggetti mostra informazioni sull'oggetto selezionato. Fai clic su qualsiasi esplorazione, visualizzazione, campo o unione nel canvas del diagramma per aprire lo strumento di profilazione degli oggetti sul lato destro del canvas. Fai clic sul canvas per comprimere lo strumento di profilazione degli oggetti.

Esplorazioni

Fai clic sull'icona Informazioni sull'esplorazione, un "i" racchiuso in un cerchio, sul lato destro della barra del titolo dell'oggetto.

Per l'esplorazione selezionata nel riquadro Impostazioni diagramma, lo strumento di profilazione degli oggetti mostra:

  • Etichetta: il valore dell'esplorazione label.
  • Etichetta gruppo: il valore del parametro group_label, che combina le esplorazioni in gruppi personalizzati nel menu Esplora di Looker. Se per l'esplorazione non è definita un'etichetta di gruppo, per impostazione predefinita viene utilizzato il nome del modello.
  • Nome progetto: il nome del progetto LookML, come definito nelle impostazioni del progetto.
  • Nome connessione: il valore del parametro connection, che specifica la connessione al database da cui un modello recupererà i dati.

Se disponi delle autorizzazioni per visualizzare il codice LookML, puoi fare clic su Vai a LookML in basso a sinistra in Object Profiler per aprire il file in cui è definita l'esplorazione. Il file si apre in una nuova scheda del browser con la riga relativa a explore evidenziata.

Visualizzazioni

Fai clic su una visualizzazione dal canvas del diagramma.

Lo strumento di profilazione degli oggetti mostra il nome della tabella SQL, se definito nel codice LookML della visualizzazione. Se non è definito alcun sql_table_name per la vista, il nome della tabella SQL viene visualizzato come unknown.

Se disponi delle autorizzazioni per visualizzare il codice LookML, puoi fare clic su Vai a LookML in basso a sinistra in Object Profiler per aprire il file in cui è definita l'esplorazione a cui è unita la visualizzazione. Il file si apre in una nuova scheda del browser con la riga relativa a explore evidenziata.

Campi

Fai clic su un campo del canvas del diagramma.

Nella parte superiore del riquadro, lo strumento di profilazione degli oggetti mostra il nome, il tipo e il valore del campo, nonché se il campo è una chiave primaria. Nel profiler sono disponibili due schede, Dettagli e Codice, che mostrano informazioni aggiuntive sul campo.

Nella scheda Dettagli puoi visualizzare:

  • Nome vista: il nome della visualizzazione a cui appartiene il campo.
  • Etichetta: il modo in cui il campo viene visualizzato nella sezione Dati di un'esplorazione, ovvero il nome o l'etichetta della visualizzazione seguito dal nome o dall'etichetta del campo.
  • Distribuzione: per le dimensioni numeriche in una visualizzazione con una misura che ha type: count, fai clic su Calcolo per visualizzare un'anteprima di un grafico a colonne che mostra la distribuzione dei valori di conteggio. La sezione Distribuzione mostra anche i valori minimo, massimo e medio della serie di dimensioni numeriche.
  • Valori: per le dimensioni numeriche in una visualizzazione con una misura che ha type: count, fai clic su Calcola per visualizzare un'anteprima dei valori di conteggio. Fai clic su Scopri di più per aprire l'esplorazione a cui appartiene questo campo.

Nella scheda Codice, puoi visualizzare il parametro e i sottoparametri del campo.

Se disponi delle autorizzazioni per visualizzare il codice LookML, puoi fare clic su Vai a LookML in basso a sinistra in Object Profiler per aprire il file in cui è definito l'unione. Il file si apre in una nuova scheda del browser nella riga relativa all'esplorazione dell'unione.

Se disponi delle autorizzazioni per esplorare i dati, fai clic su Esplora con campo in basso a destra in Object Profiler per aprire un'esplorazione con il campo preselezionato nel selettore dei campi di esplorazione.

Unioni

Fai clic su una congiunzione dal riquadro del diagramma.

Lo strumento di analisi degli oggetti mostra l'istruzione join che descrive la relazione di join e il tipo e la cardinalità della join.

Se disponi delle autorizzazioni per visualizzare il codice LookML, puoi fare clic su Vai a LookML in basso a sinistra in Object Profiler per aprire il file in cui è definito l'unione. Il file si apre in una nuova scheda del browser nella riga relativa all'esplorazione dell'unione.