Utilizzo del diagramma LookML

Il diagramma LookML è un'estensione, un'applicazione web creata utilizzando i componenti Looker, sviluppata mediante il framework delle estensioni Looker e distribuita tramite Looker Marketplace.

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

  • Valuta la struttura del modello LookML, identificando le aree in cui LookML può essere consolidato e determinando come migliorarlo
  • Identifica una logica errata, riducendo le probabilità di calcoli errati e prestazioni delle query scadenti
  • Scopri come eseguire la modellazione dei dati basata su codice (LookML)

In questa pagina della documentazione viene descritto come utilizzare lo schema LookML versione 2.0.0. e successive. Gli amministratori di Looker devono fare riferimento alla pagina della documentazione Configurazione dell'estensione diagramma LookML per istruzioni su come abilitare questa estensione per gli utenti di Looker.

Questa pagina illustra come:

Una volta installato il diagramma LookML, puoi accedere al diagramma LookML facendo clic su Blocchi nel pannello di navigazione a sinistra, quindi selezionando il riquadro Diagramma LookML.

Osservazione delle relazioni degli oggetti LookML con il diagramma LookML

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

L'estensione LookML Diagram è costituita da questi 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 ai diagrammi per fornire ulteriori spiegazioni degli elementi del diagramma.
  4. Un canvas di diagramma per interagire con gli oggetti LookML nell'esplorazione selezionata
  5. Un elenco selezionato di campi Explore, raggruppati per view
  6. Una barra degli strumenti con opzioni di zoom e posizione e un'icona che consente di mostrare o nascondere la mini mappa in canvas, che consente di orientarsi in un diagramma più grande.
  7. un Profiler oggetti per visualizzare le informazioni sull'oggetto LookML e passare al LookML o all'esplorazione associato, se applicabile

Fai doppio clic sull'icona Impostazioni diagramma o sull'icona Visualizza opzioni 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 le Impostazioni diagramma.

L'elenco a discesa Scegli un modello elenca tutti i modelli per i quali disponi delle autorizzazioni per la visualizzazione. Dopo aver selezionato un modello, vengono visualizzate due opzioni aggiuntive:

  • Il menu a discesa Ramo corrente viene compilato con un elenco dei rami Git del modello. Se il modello ha un solo ramo, di solito il ramo di produzione, viene visualizzato questo ramo. Se sei in modalità produzione o non hai l'autorizzazione per modificare i rami Git, il menu a discesa Ramo attuale è disabilitato.

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

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

Esplora le opzioni di visualizzazione

Se selezioni Esplora, puoi utilizzare il riquadro Opzioni di visualizzazione per limitare i campi e le visualizzazioni visualizzati sul canvas.

Limitazione dei campi visualizzati

Puoi scegliere di visualizzare tutti i campi in ogni vista dell'esplorazione selezionando Tutti i campi in Campi da visualizzare oppure Mostra i campi uniti ad altri campi.

Se l'opzione è attivata, l'opzione Nascondi campi nascosti nasconde tutti i campi che contengono hidden: yes nel proprio LookML sottostante. L'opzione Nascondi campi nascosti è abilitata per impostazione predefinita.

Limitazione delle visualizzazioni visualizzate

La sezione Viste del riquadro Opzioni di visualizzazione mostra un elenco delle viste presenti nell'esplorazione selezionata. Per impostazione predefinita, tutte le visualizzazioni vengono visualizzate nel canvas del diagramma. Quando nascondi una vista, l'oggetto vista e tutti i join che collegano l'oggetto vista a qualsiasi altro oggetto in Esplora sono nascosti dal canvas del diagramma.

Fai clic su Nascondi tutto per nascondere tutte le viste nella tela del diagramma. Fai clic su Mostra tutto per mostrare tutte le visualizzazioni dell'esplorazione.

Puoi anche nascondere selettivamente le singole visualizzazioni dalla tela deselezionando l'icona a forma di occhio a destra del nome della visualizzazione. Quando la visualizzazione è nascosta, il nome della visualizzazione è in grigio e l'icona a forma di occhio è barrata. Per mostrare una singola visualizzazione nascosta, fai clic sull'icona a forma di occhio.

Interpretare il canvas del diagramma

Il canvas del diagramma LookML è il punto in cui vengono rappresentate tutte le entità e le relazioni per una determinata esplorazione. Nel vernacolo Looker puoi pensare al diagramma LookML come a come gli oggetti LookML vengono uniti in un'esplorazione per un determinato modello.

La barra del titolo dell'oggetto nella parte superiore della tela mostra il nome dell'esplorazione le cui visualizzazioni sono visualizzate sulla tela. Fai clic sull'icona Esplora informazioni, ovvero una "i" cerchiata, 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 di Explore è rappresentata come un insieme di entità a sé stante, con il nome della visualizzazione in cima all'insieme:

  1. La vista di base di Esplora è indicata da uno sfondo blu scuro.
  2. Le viste unite in Esplora hanno uno sfondo azzurro.

  3. Quando selezioni un campo di join, una vista o un campo, questo viene evidenziato in blu.

    Sotto ciascuna vista è riportato un elenco dei campi appartenenti alla vista:

  4. Le dimensioni sono elencate in alto.

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

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

A sinistra di ciascun 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
  • Segno di spunta: dimensioni di type: yesno
  • Calendario: 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 Profiler oggetti e scoprire di più sul campo selezionato.

Relazioni

Il diagramma utilizza una linea per rappresentare la relazione tra ciascun oggetto e un altro oggetto nel modello selezionato. La forma della linea, dove si collega alla vista o al campo, trasmette la cardinalità della relazione tra i due oggetti; una linea forcella indica una cardinalità "molte" e una singola linea indica una cardinalità "uno". Questo rapporto viene letto come dalla visualizzazione di base a la vista unita. Ecco alcuni esempi:

  1. Un join one-to-one da order_items a inventory_items, partecipazione al campo id
  2. Unione a più persone da order_items a repeat_purchase_facts

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

Fai clic sulla riga per aprire lo strumento Profiler oggetti per visualizzare ulteriori informazioni sul join.

Opzioni di visualizzazione delle tele

Una mini mappa in alto a destra della tela può aiutarti a orientare il posizionamento all'interno di diagrammi più grandi: la parte non visibile della mappa indica la porzione del diagramma attualmente mostrata sulla tela. Fai clic e trascina lo spazio vuoto nel canvas per passare ad altre parti del diagramma.

Una barra degli strumenti verticale nella parte in basso a sinistra del canvas contiene icone per controllare la visualizzazione del diagramma:

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

Visualizzazione delle informazioni sugli oggetti con Profiler

Profiler dell'oggetto mostra informazioni sull'oggetto selezionato. Fai clic su Esplora, visualizza, sul campo o partecipa alla tela del diagramma per aprire Profiler oggetti sul lato destro del canvas. Fai clic sulla tela per comprimere il Profiler dell'oggetto.

Esplorazioni

Fai clic sull'icona Esplora informazioni, ovvero una "i" circondata sul lato destro della barra del titolo dell'oggetto.

Per l'esplorazione selezionata nel riquadro Impostazioni diagramma, il Profiler dell'oggetto mostra:

  • Etichetta: il valore dell'esplorazione label.
  • Group Label (Etichetta gruppo): il valore del parametro group_label, che combina Esplora in gruppi personalizzati nel menu Sfoglia di Looker. Se l'etichetta del gruppo non è definita per l'esplorazione, il valore predefinito sarà 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 recupera i dati.

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

Visualizzazioni

Fai clic su una visualizzazione dalla tela del diagramma.

Profiler profilo visualizza il Nome tabella SQL se definito nel LookML della vista. Se nella vista non è definito sql_table_name, il Nome tabella SQL viene visualizzato come unknown.

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

Campi

Fai clic su un campo nel canvas del diagramma.

Profiler visualizza il nome del campo, il tipo e il valore del tipo e indica se il campo è una chiave primaria nella parte superiore del riquadro. Due schede nel Profiler (Dettagli e Codice) mostrano informazioni aggiuntive sul campo.

Nella scheda Dettagli puoi visualizzare:

  • Nome vista: il nome della vista a cui appartiene il campo.
  • Etichetta: il modo in cui il campo verrà visualizzato nella sezione Dati di un'esplorazione, ovvero il nome o l'etichetta della vista, seguito dal nome o dall'etichetta del campo.
  • Distribuzione: per le dimensioni numeriche in una vista con una misura che presenta type: count, fai clic su Calcola per mostrare un'anteprima di un grafico a colonne che rappresenta la distribuzione dei valori di conteggio. Nella sezione Distribuzione vengono visualizzati anche i valori minimo, massimo e medio della serie di dimensioni numeriche.
  • Valori: per le dimensioni numeriche in una vista con una misura che presenta type: count, fai clic su Calcola per mostrare un'anteprima dei valori di conteggio. Fai clic su Esplora altro per aprire la risorsa Esplora a cui appartiene questo campo.

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

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

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

Unioni

Fai clic su un join dalla tela del diagramma.

Profiler mostra l'istruzione join che descrive la relazione di join e il tipo e la cardinalità dell'unione.

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