Modella i dati in LookML

LookML e l'IDE di Looker ti consentono di definire modelli di dati, dimensioni e relazioni riutilizzabili basati sulle tabelle del tuo database. In questa guida rapida, creerai un file del modello e un file di vista, configurerai un'esplorazione e testerai una nuova dimensione utilizzando il progetto LookML di esempio in Looker (Google Cloud core). Imparerai anche ad attivare la modalità di sviluppo, a navigare nell'IDE di Looker e a utilizzare la Guida rapida.

Prima di iniziare

Per seguire questa guida rapida, devi disporre di quanto segue:

Ruoli obbligatori

Per completare questa guida rapida, devi disporre del ruolo Identity and Access Management (IAM) e del ruolo Looker appropriati.

Ruoli di Identity and Access Management

L'amministratore di Looker (Google Cloud core) ti concede l'accesso all'applicazione Looker (Google Cloud core) tramite il sistema Identity and Access Management di Google Cloud.

Per ottenere l'autorizzazione necessaria per accedere all'applicazione Looker (Google Cloud core), chiedi all'amministratore di concederti il ruolo IAM Utente istanza Looker (roles/looker.instanceUser) nel progetto Google Cloud che contiene l'istanza di Looker (Google Cloud core). Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione looker.instances.login necessaria per accedere all'applicazione Looker (Google Cloud core).

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Autorizzazioni di Looker

Devi disporre di un account utente Looker con il ruolo Amministratore di Looker o l'autorizzazione develop.

Attiva la modalità di sviluppo

I progetti Looker possono esistere in una delle due modalità: modalità di produzione e modalità di sviluppo. La modalità di sviluppo ti consente di apportare modifiche ai file LookML e di visualizzare in anteprima l'impatto che avranno sui contenuti della tua istanza senza influire sull'ambiente di produzione (ciò che vedono gli altri utenti). Per ulteriori informazioni, consulta la pagina della documentazione relativa alla modalità di sviluppo e alla modalità di produzione.

Per questa guida rapida, utilizzerai la modalità di sviluppo in modo da poter apportare modifiche ai file LookML e testarle in un'esplorazione.

Per attivare la modalità di sviluppo, segui questi passaggi:

  1. Nella home page di Looker (Google Cloud core), fai clic sull'icona del menu principale di Looker per espandere il menu di navigazione principale, se non è già espanso.
  2. Seleziona il pulsante di attivazione/disattivazione Modalità di sviluppo nella parte inferiore del menu.

Quando la modalità di sviluppo è attiva, Looker mostra il banner Modalità di sviluppo nella parte superiore dello schermo.

Un progetto LookML è una raccolta di file LookML che indicano a Looker come connettersi al tuo database, come eseguire query sui dati e come presentarli nell'interfaccia utente. In questa guida rapida, utilizzerai il progetto LookML di esempio configurato automaticamente sulle istanze di Looker (Google Cloud core).

Per accedere ai file di progetto LookML di esempio nell'IDE di Looker, segui questi passaggi:

  1. Fai clic sull'icona del menu principale di Looker e seleziona Sviluppo, se il menu Sviluppo non è già visualizzato.
  2. Dal menu Sviluppo, seleziona sample_thelook_ecommerce.

Looker aprirà il riquadro Browser file dell'IDE di Looker e mostrerà i file del progetto LookML di esempio.

Crea una nuova cartella di progetto

Per mantenere i file che crei in questa guida rapida separati dal resto dei file nel progetto di esempio LookML, creerai una nuova cartella di progetto per i file della guida rapida.

Per creare una cartella nel progetto, segui questi passaggi:

  1. Nel riquadro Browser file dell'IDE di Looker, fai clic sull'icona Aggiungi file o cartella nella parte superiore del riquadro e seleziona l'opzione Crea cartella dal menu Aggiungi file o cartella.

  2. Come nome della nuova cartella, inserisci quickstart.

  3. Fai clic su Crea.

Looker aggiunge la nuova cartella al riquadro Browser file nell'IDE di Looker.

Ulteriori informazioni sulle cartelle IDE

Per saperne di più sull'utilizzo delle cartelle nel progetto LookML, consulta le seguenti pagine della documentazione:

Crea un nuovo file del modello LookML

Un file di modello LookML specifica una connessione al database e l'insieme di esplorazioni di Looker che utilizzano la connessione. Un'esplorazione è un punto di partenza per consentire agli utenti di eseguire query sui dati in Looker dopo che sono stati modellati in LookML (consulta Visualizzazione e interazione con le esplorazioni in Looker).

Per creare un nuovo file del modello nel progetto LookML, segui questi passaggi:

  1. Nel riquadro Browser file dell'IDE di Looker, seleziona il menu con tre puntini Opzioni cartella per la cartella quickstart che hai creato nella procedura Crea una nuova cartella di progetto.
  2. Dal menu Opzioni cartella, seleziona Crea modello.
  3. Nella finestra di dialogo Crea file, inserisci il nome quickstart_practice per il nuovo file, quindi fai clic su Crea. Looker crea il file quickstart_practice.model nella cartella quickstart e apre il nuovo file nell'IDE di Looker. Il punto blu accanto al file nel riquadro Browser file indica che il file è nuovo.
  4. Nel riquadro Browser di file, fai clic sulla cartella quickstart per espanderla e visualizzare il file quickstart_practice.model.
  5. Nell'IDE di Looker, fai clic sul file quickstart_practice.model per aprirlo, se non è già aperto.

Il file quickstart_practice.model contiene un esempio di LookML che puoi utilizzare come punto di partenza per il tuo progetto. Per il momento, puoi mantenere il file così com'è. Più avanti nella guida rapida, creerai delle esplorazioni nel file del modello.

Informazioni aggiuntive sui file del modello

Per creare i tuoi file di modello in futuro, tieni presente le seguenti risorse:

Crea un nuovo file di visualizzazione LookML

In LookML, una vista corrisponde a una singola tabella nel database o a una singola tabella derivata. Il file di visualizzazione specifica la tabella del database su cui eseguire la query e i campi (dimensioni e misure) da includere da quella tabella del database. Dopo aver definito un campo nel file della vista, puoi utilizzare l'operatore di sostituzione $ per fare riferimento al campo in altre parti di LookML. In questo modo puoi definire il campo in un'unica posizione e utilizzarlo in più punti del progetto LookML.

Esistono diversi modi per creare un nuovo file di visualizzazione, ma il modo più semplice per iniziare è fare in modo che Looker generi automaticamente un file di visualizzazione in base a una tabella esistente nel database.

Per fare in modo che Looker generi un nuovo file di visualizzazione, segui questi passaggi:

  1. Nel riquadro Browser file dell'IDE di Looker, seleziona il menu con tre puntini Opzioni cartella per la cartella quickstart che hai creato nella procedura Crea una nuova cartella di progetto.
  2. Seleziona Crea visualizzazione da tabella dal menu Opzioni cartella.

  3. Nella pagina Crea viste dalle tabelle, fai clic sul campo di immissione Inserisci database personalizzato e digita bigquery-public-data:

    La finestra di dialogo Crea visualizzazioni da tabelle.

  4. Premi Invio per visualizzare i set di dati pubblici di BigQuery.

  5. Scorri l'elenco fino a trovare il set di dati thelook_ecommerce.

  6. Fai clic sul set di dati thelook_ecommerce per espanderlo.

  7. Seleziona la tabella order_items.

  8. Fai clic sul pulsante Crea visualizzazioni nella parte inferiore della pagina.

Looker visualizza il file di visualizzazione order_items nell'IDE di Looker. Nel riquadro File Browser, la cartella quickstart è espansa e il file di visualizzazione order_items è mostrato con un punto blu per indicare che si tratta di un nuovo file.

Informazioni aggiuntive sui file di visualizzazione

Per creare i tuoi file di visualizzazione in futuro, tieni presente le seguenti risorse:

Guida rapida dell'IDE di Looker

Ora hai creato un file del modello LookML e un file della vista LookML. Nei passaggi successivi di questa guida rapida, inizierai a modificare questi file. Prima di iniziare a modificare, dovresti acquisire familiarità con la funzionalità Guida rapida dell'IDE di Looker. Il riquadro Guida rapida fornisce spiegazioni e opzioni per la posizione corrente del cursore nei file LookML:

  • Nel riquadro dell'editor dell'IDE, puoi fare clic sui campi e sui parametri nei file LookML e il riquadro Guida rapida mostrerà le opzioni e i sottoparametri supportati per quell'elemento LookML.
  • Nel riquadro Guida rapida, puoi fare clic sul nome di un parametro per aprire la pagina della documentazione di Looker relativa a quel parametro.

Se il riquadro Guida rapida non è già aperto, puoi aprirlo facendo clic sull'icona Guida rapida nell'IDE di Looker:

Crea esplorazioni per le tue visualizzazioni

Dopo aver eseguito la procedura Crea un nuovo file modello LookML e la procedura Crea un nuovo file di visualizzazione LookML, puoi definire un'esplorazione per il nuovo file di visualizzazione in modo da poter utilizzare Looker per eseguire query sui dati che hai modellato nel file di visualizzazione.

Le esplorazioni vengono in genere definite in un file del modello. (Puoi creare un file Explore separato, ma ai fini di questa guida rapida, creerai l'esplorazione nel file del modello.)

Nel file LookML in cui definisci un'esplorazione, devi utilizzare il parametro include per poter fare riferimento al file della vista nella definizione dell'esplorazione. Questa procedura ti guiderà attraverso questi passaggi.

Per creare un'esplorazione per il file di visualizzazione order_items, segui questi passaggi:

  1. Nell'IDE di Looker, apri il file quickstart_practice.model.

  2. Nel file quickstart_practice.model, sostituisci la riga esistente contenente il parametro include con la riga seguente:

    include: "/quickstart/order_items.view"

  3. Aggiungi una nuova riga sotto il parametro include e inserisci il seguente LookML: alue, che puoi selezionare dal campo none explore: order_items {}

  4. Fai clic sul pulsante Salva modifiche nella parte superiore dell'IDE di Looker.

Questa esplorazione è l'esempio più semplice di un'esplorazione che consente agli utenti di eseguire query sulla vista order_items. Da questo punto di partenza, puoi creare l'esplorazione in molti modi.

Ulteriori informazioni sulle esplorazioni

Per creare le tue esplorazioni in futuro e svilupparle, tieni presente le seguenti risorse:

Crea un nuovo campo

Dopo aver creato i file di visualizzazione nella sezione Crea un nuovo file di visualizzazione LookML di questa guida rapida, puoi visualizzare i campi creati automaticamente da Looker. Quando crei un file di visualizzazione basato su una tabella di database, Looker crea automaticamente dimensioni, gruppi di dimensioni e misure:

  • Una dimensione è un campo che rappresenta un attributo, un fatto o un valore che gli utenti possono selezionare dal selettore campi all'interno di un'esplorazione e che può essere utilizzato per filtrare una query. Se il campo non si trova all'interno di una funzione di aggregazione come SUM, COUNT e simili, si tratta di una dimensione. Looker crea automaticamente una dimensione per ogni colonna della tabella del database.
  • Un gruppo di dimensioni viene utilizzato per creare un insieme di dimensioni basate sul tempo o sulla durata tutte in una volta. Ad esempio, il gruppo di dimensioni per una colonna timestamp conterrà singole dimensioni per data, mese, trimestre, ora, settimana e anno. Looker crea automaticamente un gruppo di dimensioni per i campi basati sul tempo che rileva nella tabella del database.
  • Una misura è un campo di un'esplorazione che rappresenta informazioni misurabili sui tuoi dati, come somme, conteggi e così via. Una misura viene dichiarata in un file di visualizzazione e può essere di tipo aggregato o non aggregato. Looker crea automaticamente una misura di type:count per il file della vista, che equivale a un COUNT(*) in SQL.

In questa sezione imparerai ad aggiungere manualmente la tua dimensione al file di visualizzazione order_items.

Per creare manualmente una nuova dimensione nel file di visualizzazione order_items, segui questi passaggi:

  1. Apri il file quickstarts/order_items.view se non è già aperto: nel riquadro Browser file dell'IDE di Looker, fai clic sulla cartella quickstart per espanderla, quindi fai clic sul file order_items.view per aprirlo.
  2. Nel file quickstarts/order_items.view, crea una nuova riga prima del primo parametro dimension nel file.

  3. Nella nuova riga, inizia a digitare dimension. Mentre digiti, l'IDE di Looker visualizzerà un elenco di possibili parametri che iniziano con il testo che hai digitato.

    • Utilizza i tasti Freccia per spostarti nell'elenco dei suggerimenti fino all'opzione dimension.
    • Premi Invio per inserire il parametro selezionato nel codice LookML. Looker inserirà un nuovo parametro dimension nella nuova riga che hai creato.

  4. Per assegnare un nome alla nuova dimensione, fai clic nell'IDE prima di {} e digita shipped_to_delivered_days.

  5. Fai clic all'interno di {} e premi Invio per creare una nuova riga all'interno di {}.

  6. Completa il LookML per la nuova dimensione (puoi copiare e incollare il seguente LookML o inserirlo manualmente per vedere come l'IDE di Looker fornisce indicazioni):

    dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}

  7. Nella parte superiore dell'IDE di Looker, fai clic sul pulsante Salva modifiche.

Looker salverà il file della vista con la nuova dimensione. Per le nuove righe del file, l'IDE di Looker ombreggia i numeri di riga in verde.

Ulteriori informazioni sui campi LookML

Per creare i tuoi campi in futuro, tieni presente le seguenti risorse:

  • Per informazioni generali sui campi LookML, consulta la pagina della documentazione Riferimento ai campi LookML.
  • Per informazioni sui tipi di dimensioni, filtri e parametri che puoi creare in un file di visualizzazione, consulta la pagina della documentazione Tipi di dimensioni, filtri e parametri.
  • Per informazioni sui tipi di misure che puoi creare in un file di visualizzazione, consulta la pagina della documentazione Tipi di misure.

Visualizza e testa le modifiche nell'interfaccia utente di Looker

Se hai eseguito la procedura Crea esplorazioni per le tue visualizzazioni per creare un'esplorazione per il file di visualizzazione order_items, puoi vedere la nuova dimensione nell'interfaccia utente di Esplora di Looker.

Per visualizzare e testare le modifiche nella sezione Esplora della UI di Looker, segui questi passaggi:

  1. Dal file quickstarts/order_items.view nell'IDE di Looker, fai clic sull'icona a forma di freccia Visualizza azioni file accanto al nome del file di visualizzazione nella parte superiore del riquadro dell'editor di file e seleziona l'opzione Explore Order Items - quickstart_practice.

    Il menu Azioni file, con l'opzione Esplora articoli dell'ordine - quickstart_practice selezionata.

  2. Nel selettore campi dell'esplorazione Order Items, fai clic sull'etichetta del gruppo Other Dates per espanderla, quindi fai clic sulla dimensione Shipped to Delivered Days per aggiungerla all'esplorazione. Puoi anche cercare la dimensione digitando Shipped to Delivered Days nella casella di ricerca del selettore campi.

  3. Nel selettore campi di Explore Order Items, fai clic sull'etichetta del gruppo Shipped Date per espanderla, quindi fai clic sulla dimensione Date per aggiungerla a Explore.

  4. Nel selettore campi dell'esplorazione Order Items (Articoli dell'ordine), fai clic sull'etichetta del gruppo Delivered Date (Data di consegna) per espanderla, quindi fai clic sulla dimensione Date (Data) per aggiungerla all'esplorazione.

  5. Fai clic sul pulsante Esegui nella parte superiore della pagina Esplora.

Looker eseguirà la query e mostrerà i risultati nella sezione Dati di Esplora. Per ogni riga, puoi verificare che il valore in Order Items Shipped to Delivered Days (Giorni tra la spedizione e la consegna degli articoli dell'ordine) mostri il numero corretto di giorni tra il valore Order Items Shipped Date (Data di spedizione degli articoli dell'ordine) e il valore Order Items Delivered Date (Data di consegna degli articoli dell'ordine).

Convalida il tuo LookML

Ai fini di questa guida rapida, non è necessario convalidare il codice LookML. Tuttavia, in futuro, quando creerai i tuoi progetti per modellare i dati, è utile conoscere gli strumenti di Looker per convalidare LookML.

Mentre modifichi il codice LookML, l'IDE di Looker ti avviserà di eventuali errori di sintassi non risolti all'interno di un singolo file (consulta la pagina della documentazione Panoramica dell'IDE di Looker). Puoi anche eseguire una convalida completa del modello, che verificherà la presenza di eventuali errori nel LookML. Per ulteriori informazioni, consulta la pagina della documentazione Convalida di LookML.

Esegui il commit delle modifiche

In questa guida rapida, utilizzerai una connessione Git preconfigurata per il progetto LookML di esempio. Tuttavia, in futuro, quando creerai i tuoi progetti per modellare i dati, dovrai configurare una connessione Git per il tuo progetto.

Man mano che apporti modifiche ai file di progetto LookML, l'IDE di Looker mostrerà diverse operazioni per il pulsante Git nell'angolo in alto a destra dell'IDE. Il pulsante mostra diverse operazioni per guidarti nel processo di convalida del LookML e di deployment delle modifiche in produzione.

I file LookML e l'esplorazione che hai visualizzato in questa guida rapida sono disponibili solo nel tuo ramo Git personale in modalità di sviluppo. Se vuoi rendere questo modello disponibile ad altri utenti nella tua istanza di Looker (Google Cloud core), devi eseguire il commit delle modifiche, unire il branch ed eseguire il deployment del branch di produzione.

Ai fini di questa guida rapida, non eseguirai il deployment delle modifiche in produzione. Dovrai invece eliminare questi file, come descritto nella procedura di pulizia.

Esegui la pulizia

Per massimizzare le prestazioni di Looker, non è necessario eseguire il deployment dei modelli non necessari in produzione. Per mantenere pulito il tuo branch Git personale ed evitare di eseguire accidentalmente il deployment di questi file in produzione, completa i seguenti passaggi per eliminare i file che hai creato in questa guida rapida:

  1. Fai clic sull'icona del menu principale di Looker e seleziona Sviluppo, se il menu Sviluppo non è già visualizzato.
  2. Dal menu Sviluppo, seleziona sample_thelook_ecommerce.
  3. Nel riquadro Browser file dell'IDE di Looker, seleziona il menu con tre puntini Opzioni cartella per la cartella quickstart che hai creato nella procedura Crea una nuova cartella di progetto.
  4. Seleziona Elimina dal menu Opzioni cartella.
  5. Nella finestra Elimina cartella, fai clic su Elimina.

Looker elimina la cartella quickstart e tutti i relativi contenuti.

Passaggi successivi