Panoramica dell'IDE di Looker

L'IDE (ambiente di sviluppo integrato) di Looker fornisce l'accesso ai file del progetto LookML e alle relative impostazioni.

Accedere all'IDE di Looker

Per visualizzare un progetto LookML, devi disporre dell'autorizzazione develop per almeno un modello nel progetto. Puoi accedere all'IDE di Looker tramite il pannello Sviluppa del menu di navigazione principale di Looker:

  1. Seleziona Sviluppa nel pannello di navigazione per aprire il pannello Sviluppa.
  2. Nel riquadro Sviluppa, seleziona il nome del progetto a cui vuoi accedere.

Looker apre l'IDE per il progetto LookML selezionato.

In alternativa, puoi aprire l'IDE per oggetti LookML specifici da un'esplorazione o dal browser degli oggetti. Per maggiori dettagli e altre opzioni, consulta Accedere ai file del progetto.

Elementi dell'IDE di Looker

L'IDE di Looker contiene i seguenti elementi:

  1. Banner della modalità di sviluppo: questo banner indica che sei in modalità di sviluppo, in cui puoi apportare modifiche ai file LookML e visualizzare l'anteprima dell'impatto che avranno sui contenuti della tua istanza. Puoi fare clic sul link Esci dalla modalità di sviluppo nel banner per passare alla modalità di produzione.
  2. Barra di navigazione dell'IDE: utilizza la barra di navigazione per accedere a diverse funzionalità dell'IDE di Looker. Alcune funzionalità sono disponibili solo in modalità di sviluppo. Dopo aver selezionato una funzionalità dalla barra di navigazione dell'IDE, puoi selezionare l'elemento della barra di navigazione una seconda volta per comprimere il riquadro delle funzionalità. La barra di navigazione dell'IDE fornisce l'accesso alle seguenti funzionalità dell'IDE:
    • Browser dei file: apre il browser dei file, che ti consente di accedere ai file e alle cartelle del tuo progetto LookML.
    • Browser degli oggetti: apre il browser degli oggetti, che mostra gli oggetti LookML nel progetto e le relazioni gerarchiche tra gli oggetti.
    • Trova e sostituisci: viene visualizzata la pagina Trova e sostituisci nel progetto, che puoi utilizzare per cercare testo in tutti i file del progetto e poi sostituire tutte le istanze o quelle selezionate in un'operazione collettiva.
    • Azioni Git: (visibile solo in modalità di sviluppo) mostra i rami Git del progetto e i comandi Git disponibili per il ramo Git del progetto. Per informazioni sull'utilizzo di Git con il tuo progetto LookML, consulta la pagina della documentazione Utilizzo del controllo della versione e del deployment.
    • Impostazioni: (visibile solo in modalità di sviluppo) mostra le pagine delle impostazioni del progetto in cui puoi configurare le opzioni di controllo della versione del progetto, le credenziali di autenticazione per i progetti importati, i rami Git utilizzati dal progetto e le impostazioni IDE.
    • Esegui il deployment: (visibile solo in modalità di sviluppo) per i progetti configurati con la modalità di deployment avanzata, apre Deployment Manager, dove gli sviluppatori che dispongono dell'autorizzazione deploy possono eseguire il deployment di un commit o di un tag nell'ambiente di produzione di Looker.
  3. Pannello delle funzionalità: fornisce la navigazione per i file e gli oggetti LookML per il browser di file e il browser di oggetti, i parametri di ricerca per la funzione Trova e sostituisci, i comandi Git disponibili per il pannello Azioni Git e le schede per accedere a impostazioni diverse per il pannello delle impostazioni del progetto.
  4. Riquadro dell'editor IDE: l'editor per i file LookML. L'editor viene visualizzato quando nella barra di navigazione dell'IDE è selezionato File Browser o Object Browser. Per ulteriori informazioni sull'editor, consulta Funzionalità di modifica dell'IDE di Looker.
  5. Selettore del riquadro laterale: fai clic su un'opzione per aprire le funzionalità del riquadro laterale dell'IDE:
    • Integrità del progetto: apre il riquadro Integrità del progetto.
    • Guida rapida: apre il riquadro Guida rapida, che include una scheda per accedere al riquadro Metadati.
    • Aiutami a scrivere: (per le istanze di Looker (Google Cloud core) con Gemini abilitato) apre il riquadro Aiutami a scrivere. Fai clic di nuovo sull'opzione di selezione del riquadro laterale per nasconderlo.
  6. Riquadro laterale dell'IDE: mostra la funzionalità del riquadro laterale selezionata:
  7. Pulsante Git: a seconda dello stato del progetto, il pulsante mostra l'azione successiva da eseguire per rendere il progetto di produzione, ad esempio Convalida LookML, Esegui push del ramo sul server remoto o Esegui commit. Fai clic sul pulsante per eseguire l'azione. Consulta il riferimento ai comandi Git per i possibili comandi che il pulsante può visualizzare ed eseguire.

Configurazione dell'IDE di Looker

Puoi personalizzare l'IDE di Looker nei seguenti modi:

Modalità dell'editor di testo

L'IDE di Looker supporta tre modalità di editor di testo:

  • Editor IDE di Looker (predefinito)
  • Vim
  • Emacs

Per modificare la modalità dell'editor di testo:

  1. Seleziona l'icona Impostazioni nel riquadro di navigazione a sinistra nell'IDE di Looker.
  2. Seleziona la scheda Editor in Impostazioni IDE.
  3. Utilizza il menu a discesa Modalità editor di testo per selezionare l'opzione che preferisci.

Dopo aver selezionato un'opzione dal menu a discesa, l'IDE di Looker viene aggiornata immediatamente per utilizzare la modalità di editor di testo selezionata.

Modalità di accapo delle righe

Per impostazione predefinita, l'IDE di Looker è attivato per l'a capo.

Per attivare o disattivare il ritorno a capo:

  1. Seleziona l'icona Impostazioni nel riquadro di navigazione a sinistra nell'IDE di Looker.
  2. Seleziona la scheda Editor in Impostazioni IDE.
  3. Utilizza l'opzione di attivazione/disattivazione Modalità a capo per attivare o disattivare il rientro a capo nell'IDE.

Una volta modificato il pulsante di attivazione/disattivazione, l'aggiornamento viene applicato all'IDE di Looker.

Ridimensionare i riquadri laterali dell'IDE

Puoi modificare la larghezza dei riquadri nell'IDE, sia il riquadro delle funzionalità (che contiene i riquadri File Browser, Object Browser e Azioni Git) sia il riquadro laterale (che contiene i riquadri Stato del progetto, Guida rapida e Metadati).

Per ridimensionare i riquadri dell'IDE, tieni premuto il cursore sul bordo del riquadro e trascinalo per ridimensionarlo:

Se sei in modalità di sviluppo, l'IDE mantiene le dimensioni dei riquadri laterali dopo gli accessi e gli aggiornamenti.

Comprimire i riquadri laterali dell'IDE

Se vuoi massimizzare la larghezza del riquadro dell'editor dell'IDE, puoi comprimere i riquadri laterali dell'IDE:

  • Per mostrare o nascondere il riquadro delle funzionalità dell'IDE, utilizza la scorciatoia da tastiera Comando-B (Mac) o Ctrl+B (Windows) oppure fai clic su un'icona già selezionata nella barra di navigazione dell'IDE.
  • Per mostrare o nascondere il riquadro laterale dell'IDE, fai clic su un'icona già selezionata nel selettore del riquadro laterale.

Funzionalità di editing dell'IDE di Looker

Le sezioni seguenti descrivono alcune delle funzionalità di modifica dell'IDE di Looker che possono aiutarti a sviluppare in LookML:

Suggerimenti automatici

Mentre digiti, l'IDE suggerisce possibili parametri e valori sensibili al contesto di ciò che stai digitando. Ad esempio, i suggerimenti per il parametro type di una dimensione includeranno solo le opzioni valide per quel parametro. Inoltre, i campi nei parametri sql devono essere contrassegnati con ${...}, quindi l'IDE aggiunge questa sintassi quando suggerisce i campi.

Il completamento automatico viene visualizzato automaticamente ovunque possa essere mostrato. Per chiuderlo, premi il tasto Esc sulla tastiera. Per visualizzarlo in qualsiasi momento, premi Ctrl+Barra spaziatrice (Windows) o Control+Barra spaziatrice (Mac).

Controllo degli errori ad hoc

L'IDE rileva gli errori di sintassi durante la digitazione. Una X rossa nel riquadro indica un errore di sintassi, che è sottolineato in rosso. Quando passi il cursore del mouse sopra la X rossa, viene visualizzata una breve descrizione del problema. Ad esempio, se per errore digiti avrage anziché average come valore del parametro type per una misura, l'IDE mostra l'errore Invalid value for "type":avrage.

Lo strumento di convalida LookML è comunque necessario per eseguire una convalida completa del modello. Alcuni errori, come un riferimento a un campo non valido causato da una join mancante, richiedono un esame olistico del modello e vengono visualizzati solo quando viene eseguito lo strumento di convalida LookML.

Formattazione automatica

In modalità di sviluppo, puoi utilizzare la scorciatoia da tastiera per la formattazione del file per rientrare automaticamente il file LookML. Il rientro indica la gerarchia dei parametri e dei sottoparametri, rendendo il codice LookML più facile da leggere e comprendere.

Pieghevole

Nella spaziatura interna accanto all'inizio di ogni parametro LookML di primo livello del file viene visualizzata una piccola freccia. Se selezioni questa freccia, la sezione di LookML si comprime o si espande in modo da poterti concentrare solo su sezioni specifiche.

Il menu Visualizza azioni file per il file LookML fornisce anche le opzioni Chiudi LookML e Apri LookML per espandere o comprimere tutte le sezioni di LookML fino al parametro di primo livello all'interno del file corrente.

Puoi anche utilizzare le scorciatoie da tastiera per comprimere e espandere il codice LookML.

Commenti

Puoi aggiungere commenti al codice LookML per renderlo più leggibile. Per aggiungere un singolo commento, utilizza il carattere #:

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

Per commentare un intero blocco di codice utilizzando le scorciatoie da tastiera, segui questi passaggi:

  1. Seleziona le righe che vuoi commentare.
  2. Premi Comando + / (Mac) o Ctrl + / (Windows).

L'IDE aggiungerà il carattere # a ogni riga selezionata.

Commentare i blocchi SQL

Se commenti righe interamente all'interno di un blocco di codice SQL, aggiungi manualmente la notazione dei commenti SQL.

Quando utilizzi il blocco di commenti SQL, le sezioni commentate verranno comunque interpretate come codice LookML. Di conseguenza, vedrai i tuoi commenti all'interno del codice SQL generato da LookML, ma i commenti non influiranno sui risultati della query.

Visualizzazione di aggiunte, modifiche ed eliminazioni

Nell'IDE LookML, diversi indicatori vengono sempre visualizzati quando sei in modalità di sviluppo e hai modifiche non committate.

  • Il nome del file viene visualizzato con un punto blu sul lato sinistro della finestra per indicare che il file è nuovo, modificato o rinominato.
  • Quando apri un file nuovo o modificato, i numeri di riga all'interno del file vengono evidenziati in verde per mostrare le righe nuove o modificate e una linea rossa orizzontale indica le righe rimosse.

Persistenza dello stato dell'IDE

Quando sei in modalità di sviluppo, l'IDE di Looker mantiene lo stato dell'IDE durante gli aggiornamenti e gli accessi. Lo stato dell'IDE include quanto segue:

  • L'elemento selezionato nella barra di navigazione dell'IDE (ad esempio il browser di file, le azioni Git, il browser di oggetti o le impostazioni del progetto)
  • Apri il file LookML visualizzato nel browser dei file
  • Stato espanso o compresso degli elementi nel browser di file e nel browser di oggetti
  • La larghezza dei riquadri laterali dell'IDE
  • L'elemento selezionato nella barra laterale destra dell'IDE (ad esempio il riquadro Guida rapida, il riquadro Metadati e il riquadro Stato del progetto)
  • La modalità di a capo delle righe dell'editor

Per reimpostare l'IDE sui valori predefiniti, seleziona l'icona Impostazioni nel riquadro di navigazione a sinistra dell'IDE di Looker, seleziona la scheda Editor nella sezione Impostazioni IDE e poi fai clic sul pulsante Reimposta layout IDE. L'IDE manterrà di nuovo lo stato mentre continui ad aprire file ed effettuare selezioni.

Vai all'oggetto o al file

Nell'IDE di Looker, puoi eseguire una ricerca rapida per passare direttamente agli oggetti LookML e ai file di progetto utilizzando la funzionalità Vai a oggetto o file. Fai clic sull'icona Vai a oggetto o file nel browser di file o nel browser di oggetti oppure utilizza la scorciatoia da tastiera ⌘J (Mac) o Ctrl+J (Windows).

Per ulteriori informazioni, consulta la pagina della documentazione Accesso ai file di progetto LookML.

Riquadro Guida rapida

Per aprire il riquadro Guida rapida, seleziona l'icona Guida rapida dal browser di file o dal browser di oggetti:

Il riquadro Guida rapida fornisce spiegazioni e opzioni per la posizione corrente nel codice:

  • 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 parametri secondari 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 al parametro.

Riquadro Aiutami a programmare

Se hai un'istanza di Looker (Google Cloud core) con Gemini abilitato, puoi utilizzare Gemini in Looker per scrivere il codice LookML:

IDE di Looker con l'icona Aiutami a programmare evidenziata.

Per maggiori dettagli, consulta la documentazione su come scrivere LookML con l'assistenza di Gemini in Looker.

Menu opzioni per file e cartelle

Nel browser di file, ogni file o cartella nel riquadro laterale sinistro ha un menu che mostra le azioni disponibili per l'elemento. Tieni premuto il cursore su un file e una cartella, quindi seleziona il menu con tre puntini Opzioni cartella (per le cartelle) o Opzioni file (per i file) per aprire il menu. Per un elemento con un nome lungo o nidificato in più cartelle, puoi accedere al menu scorrendo lateralmente nel riquadro del browser di file.

Dai menu delle opzioni, puoi creare cartelle e file, caricare file ed eliminare e spostare file e cartelle utilizzando il browser di file. Per ulteriori informazioni, consulta la pagina di documentazione Gestire file e cartelle LookML.

Quando organizzi i file di LookML con le cartelle, devi committare le modifiche e eseguirne il deployment in produzione prima che altri sviluppatori di Looker possano visualizzarle. È come qualsiasi modifica apportata al progetto LookML.

Trovare e sostituire il testo nel progetto

L'IDE di Looker dispone di una funzione di ricerca e sostituzione che puoi utilizzare per cercare del testo in tutti i file del progetto e poi sostituire tutte le istanze o quelle selezionate in un'operazione collettiva.

Per utilizzare la funzione di ricerca dell'IDE di Looker:

  1. Vai al riquadro di ricerca nell'IDE.
  2. Inserisci un termine nel campo Trova.
  3. Se vuoi, puoi selezionare Sensitivo alle maiuscole per cercare solo le istanze corrispondenti alle maiuscole inserite nel campo Trova oppure RegEX per eseguire una ricerca con espressioni regolari.
  4. Seleziona Trova.
  5. Se vuoi, puoi selezionare il nome di un file per aprirlo nell'IDE.

Se sei in modalità di sviluppo, vedrai anche il campo Sostituisci con. Per sostituire il testo nel progetto:

  1. Inserisci il testo sostitutivo nel campo Sostituisci con. Se vuoi eliminare il testo nel campo Trova anziché sostituirlo, puoi lasciare vuoto il campo Sostituisci con.

  2. Seleziona Seleziona e sostituisci per visualizzare l'anteprima della sostituzione del testo nel progetto.

  3. I risultati mostrano tutte le istanze del progetto evidenziate per la sostituzione. Puoi utilizzare le seguenti opzioni per personalizzare le istanze da sostituire:

    • Utilizza la casella di controllo accanto al riepilogo dei risultati per selezionare o deselezionare tutte le istanze dell'intero progetto.
    • Utilizza la casella di controllo accanto a una singola istanza per selezionarla o deselezionarla.
  4. Seleziona il pulsante Sostituisci selezione per applicare la sostituzione alle istanze selezionate. L'IDE mostrerà le modifiche apportate.

Creazione e test di nuovi campi

Come esempio di modifica di LookML, aggiungeremo diversi campi e poi li testeremo.

Creazione di una dimensione

Innanzitutto, aggiungeremo una nuova dimensione alla visualizzazione users che determina se un utente proviene dalla California o da New York. La dimensione sarà type: yesno, il che significa che restituirà se l'utente proviene dalla California o da New York e No in caso contrario.

Il codice LookML per la nuova dimensione è il seguente:

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

Aggiungi questa dimensione al file della visualizzazione user e poi fai clic sul pulsante Salva modifiche nel file.

Consulta gli operatori di sostituzione per scoprire di più su ${TABLE}.state.

Creazione di una misura

Aggiungeremo una nuova misura alla visualizzazione user che calcola la media dell'età dei nostri utenti. Questa misura sarà type: average e verrà aggregata nella colonna age.

Il codice LookML per questa nuova misura è il seguente:

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

Aggiungi questa misura al file della visualizzazione user e poi fai clic sul pulsante Salva modifiche nel file.

Testare i campi nell'esplorazione

Puoi testare la nuova dimensione e la nuova misura eseguendo query. Dopo aver salvato le modifiche, questi campi verranno visualizzati nel selettore di campi nell'esplorazione. Utilizza il menu a discesa Visualizza azioni file accanto al nome file della visualizzazione per accedere all'esplorazione per la visualizzazione corrente. Il menu a discesa Visualizza azioni file elenca tutte le esplorazioni basate sulla visualizzazione, incluse quelle a cui è unita la visualizzazione. Ad esempio, per accedere all'esplorazione di una vista denominata users, puoi selezionare l'opzione Utenti esplorazione dal menu a discesa Visualizza azioni file.

Nell'esplorazione Utenti, puoi selezionare i nuovi campi per aggiungerli a una query. Ad esempio, puoi creare una query con entrambi i nuovi campi che mostra l'età media degli utenti residenti in California o New York e l'età media degli utenti non residenti in questi stati:

Tabella di dati per un'esplorazione degli utenti di esempio con i campi Utenti provenienti da CA o NY (Sì/No) e Età media utenti selezionati.