Utilizzo del diagramma LookML

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

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

  • Valutare la struttura del modello LookML, identificando le aree in cui è possibile consolidare LookML e determinando il modo migliore da aggiungere al modello
  • Identificare la logica errata, riducendo le probabilità di calcoli errati e scarse prestazioni delle query
  • Scopri come eseguire la modellazione dei dati basata su codice (LookML)

Questa pagina della documentazione descrive come utilizzare il diagramma LookML versione 2.0.0 e successive. Gli amministratori di Looker devono fare riferimento alla pagina della documentazione relativa alla configurazione dell'estensione LookML Diagram per istruzioni su come abilitare questa estensione per gli utenti di Looker.

In questa pagina viene spiegato come:

Dopo aver 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 di Looker deve concederti le autorizzazioni per il modello lookml_diagram e per ogni modello che vuoi visualizzare nell'estensione.

L'estensione Diagramma LookML è composta dai seguenti elementi:

  1. Un riquadro Impostazioni diagramma per selezionare un model, un ramo Git e un'esplorazione.
  2. Un riquadro Opzioni di visualizzazione per perfezionare i campi che vuoi visualizzare
  3. Una sezione della Guida al diagramma per fornire ulteriori spiegazioni sugli elementi del diagramma
  4. Un canvas del diagramma per interagire con gli oggetti LookML nell'esplorazione selezionata
  5. Un elenco di 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 mini mappa della tela, che consente di orientarsi all'interno di un diagramma più grande
  7. Un Profiler oggetto per visualizzare le informazioni sull'oggetto LookML e accedere al rispettivo oggetto LookML o esplorazione, se applicabile

Fai doppio clic sull'icona Impostazioni diagramma o Visualizza opzioni per comprimere il riquadro a sinistra.

Configurazione delle impostazioni del diagramma

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

Nel menu a discesa Scegli un modello sono elencati tutti i modelli per i quali disponi delle autorizzazioni di visualizzazione. Dopo aver selezionato un modello, vengono visualizzate due opzioni aggiuntive:

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

    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, quindi seleziona un ramo per visualizzare il diagramma in base alla configurazione del modello nel ramo.

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

Esplora le opzioni di visualizzazione

Con un'esplorazione selezionata, puoi utilizzare il riquadro Opzioni di visualizzazione per limitare i campi e le visualizzazioni che vengono mostrati sul canvas.

Limitazione dei 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 viste che hanno campi uniti ad altri campi, seleziona Campi con unioni.

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

Limitazione delle 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 mostrate nella tela del diagramma. Quando nascondi una vista, l'oggetto della vista e le eventuali unioni che collegano l'oggetto vista a qualsiasi altro oggetto nell'esplorazione vengono nascosti dalla tela del diagramma.

Fai clic su Nascondi tutto per nascondere tutte le visualizzazioni nell'esplorazione dalla tela del diagramma. Fai clic su Mostra tutto per mostrare tutte le visualizzazioni in quell'esplorazione.

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

Interpretare il canvas del diagramma

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

La barra del titolo dell'oggetto nella parte superiore del canvas mostra il nome dell'esplorazione le cui visualizzazioni sono visibili sul canvas. Fai clic sull'icona di informazioni Esplora (una "i" cerchiata) nella barra del titolo dell'oggetto per aprire lo strumento Object Profiler e scoprire di più sull'esplorazione selezionata. Fai clic sulla freccia in senso orario per ricaricare l'estensione.

Entità

Ogni visualizzazione dell'esplorazione è rappresentata come un insieme di entità a sé stante, con il nome della visualizzazione visualizzato nella parte superiore del set:

  1. La visualizzazione di base dell'esplorazione è indicata da uno sfondo blu scuro.
  2. Le visualizzazioni unite nella sezione Esplora hanno uno sfondo azzurro.
  3. Quando selezioni un join, una visualizzazione o un campo, questo viene evidenziato in blu.

    Sotto ogni vista è presente un elenco dei campi appartenenti a quella vista:

  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 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
  • Calendar: dimensioni type: date, type: date_time, type: time
  • Punto sulla mappa: dimensioni di type: location, type: distance, type: zipcode

Fai clic sul nome del campo per aprire Object Profiler e saperne di più sul campo selezionato.

Relazioni

Il diagramma utilizza una linea per rappresentare in che modo ogni oggetto è correlato ad altri oggetti nel modello selezionato. La forma della linea, nel punto in cui si collega alla vista o al campo, trasmette la cardinalità della relazione tra i due oggetti; una linea biforcata indica una cardinalità "molti" e una linea singola indica una cardinalità "uno". Devi leggere la relazione come dalla vista di base alla vista unita. Ad esempio:

  1. Un join individuale da order_items a inventory_items, unendo il campo id
  2. Un join multiplo da order_items a repeat_purchase_facts

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

Fai clic sulla riga per aprire Object Profiler e visualizzare ulteriori informazioni sul join.

Opzioni di visualizzazione delle stampe su tela

Una mini mappa nella parte superiore destra del canvas può aiutarti a orientare il posizionamento all'interno di diagrammi più grandi, con la parte in grigio della mappa che indica quale parte del diagramma è attualmente visualizzata sul canvas. Fai clic e trascina lo spazio vuoto nel canvas per passare ad altre parti del diagramma.

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

  • Fai clic sul segno (+) per aumentare lo zoom e sul segno (-) per diminuire lo zoom del 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 mini mappa.

Visualizzazione delle informazioni sugli oggetti con Profiler oggetti

Profiler oggetto visualizza le informazioni sull'oggetto selezionato. Fai clic su qualsiasi esplorazione, visualizzazione, campo o unione sul canvas del diagramma per aprire il Profiler oggetti sul lato destro del canvas. Fai clic sul canvas per comprimere il Profiler oggetto.

Esplorazioni

Fai clic sull'icona Esplora informazioni (una "i" cerchiata) sul lato destro della barra del titolo dell'oggetto.

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

  • Etichetta: il valore dell'opzione Esplora label.
  • Etichetta gruppo: il valore del parametro group_label, che combina le esplorazioni in gruppi personalizzati nel menu Esplora di Looker. Se non viene definita un'etichetta di gruppo per l'esplorazione, 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 LookML, puoi fare clic su Vai a LookML nella parte inferiore sinistra di Profiler oggetto per aprire il file in cui è definita l'esplorazione. Il file si apre in una nuova scheda del browser con la riga explore evidenziata.

Viste

Fai clic su una vista nel canvas del diagramma.

Profiler oggetto mostra il nome tabella SQL se definito nel LookML della vista. Se non è definito alcun elemento sql_table_name per la visualizzazione, il nome tabella SQL viene mostrato come unknown.

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

Campi

Fai clic su un campo nel canvas del diagramma.

Profiler oggetto mostra il nome del campo, il tipo e il valore del tipo e se il campo è una chiave primaria nella parte superiore del riquadro. Le due schede del 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: l'aspetto del campo nella sezione Dati di un'esplorazione, che corrisponde al nome o all'etichetta della visualizzazione seguito dal nome o dall'etichetta del campo.
  • Distribuzione: per le dimensioni numeriche in una vista con una misura che ha type: count, fai clic su Calcola per visualizzare l'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 delle serie di dimensioni numeriche.
  • Valori: per le dimensioni numeriche in una vista con una misura che ha type: count, fai clic su Calcola per visualizzare un'anteprima dei valori di conteggio. Fai clic su Esplora altro 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 LookML, puoi fare clic su Vai a LookML nella parte inferiore sinistra di Profiler oggetto per aprire il file in cui è definito il join. Il file si apre in una nuova scheda del browser sulla riga dell'esplorazione dell'unione.

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

Unioni

Fai clic su un join dalla tela del diagramma.

Il Profiler oggetto mostra l'istruzione di join che descrive la relazione di join, nonché il tipo e la cardinalità del join.

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