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.

Accesso 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 Sviluppo, seleziona il nome del progetto a cui vuoi accedere.

Looker apre l'IDE per il progetto LookML che hai selezionato.

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

Elementi dell'IDE di Looker

L'IDE di Looker contiene i seguenti elementi:

  1. Banner Modalità sviluppo: questo banner indica che ti trovi in modalità di sviluppo, dove puoi apportare modifiche ai file LookML e visualizzare l'anteprima dell'effetto che avranno sui contenuti dell'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 IDE consente di accedere alle seguenti funzionalità:
    • Browser dei file: apre il browser dei file, che ti consente di accedere ai file e alle cartelle del tuo progetto LookML.
    • Browser oggetti: apre il browser oggetti, che visualizza 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: (visibili solo in modalità di sviluppo) mostra i rami Git sul tuo 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à 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 di Git utilizzati dal progetto e le impostazioni dell'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. Riquadro 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 riquadro Azioni Git e le schede per accedere a impostazioni diverse per il riquadro delle impostazioni del progetto.
  4. Riquadro 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 saperne di più 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:
    • Stato del progetto: apre il riquadro Stato del progetto.
    • Guida rapida: apre il riquadro Guida rapida, che include una scheda per accedere al riquadro Metadati.
    • Aiutami a programmare (per le istanze Looker (Google Cloud core) in cui Gemini è abilitato) apre il riquadro Aiutami a programmare. 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 dalle 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 automatico:

  1. Seleziona l'icona Settings (Impostazioni) dal riquadro di navigazione a sinistra nell'IDE di Looker.
  2. Seleziona la scheda Editor dalle Impostazioni IDE.
  3. Utilizza il pulsante di attivazione/disattivazione Modalità a capo automatico per attivare o disattivare il ritorno a capo automatico nell'IDE.

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

Ridimensionamento dei riquadri laterali dell'IDE

Puoi modificare la larghezza dei riquadri nell'IDE: sia il riquadro delle funzionalità (che contiene i riquadri Browser file, Browser oggetto 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, quindi trascinalo per ridimensionarlo:

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

Compressione dei riquadri laterali dell'IDE

Se vuoi massimizzare la larghezza del riquadro dell'editor 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 modifica dell'IDE di Looker

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

Suggerimenti automatici

Durante la digitazione, l'IDE suggerisce possibili parametri e valori sensibili al contesto del testo digitato. 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.

I suggerimenti automatici appaiono automaticamente ovunque possono essere mostrati. 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 visualizza 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

Quando sei in modalità sviluppo, puoi utilizzare la scorciatoia da tastiera del file di formato per applicare automaticamente il rientro al file LookML. Il rientro indica la gerarchia dei parametri e dei sottoparametri, rendendo il tuo LookML più facile da leggere e comprendere.

Pieghevoli

Nella grondaia viene visualizzata una piccola freccia accanto all'inizio di ogni parametro LookML di primo livello nel file. Se selezioni questa freccia, la sezione di LookML viene chiusa o aperta, in modo che tu possa concentrarti 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
}

Puoi commentare un intero blocco di codice utilizzando le scorciatoie da tastiera. A tale scopo, procedi nel seguente modo:

  1. Seleziona le righe a cui vuoi aggiungere un commento.
  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 dei commenti SQL, le sezioni con commenti verranno comunque interpretate come codice LookML. Pertanto, vedrai i tuoi commenti all'interno del codice SQL generato da LookML, ma non influiranno sui risultati della query.

Visualizzare 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 il tuo stato IDE per tutti 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 di 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 (come il riquadro Guida rapida, Metadati e integrità del progetto)
  • La modalità a capo automatico dell'editor

Per ripristinare i valori predefiniti dell'IDE, seleziona l'icona Settings (Impostazioni) dal riquadro di navigazione a sinistra nell'IDE di Looker, seleziona la scheda Editor nella sezione IDE Settings (Impostazioni IDE), quindi fai clic sul pulsante Reset IDE layout (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 rapida ricerca per passare direttamente agli oggetti LookML e ai file di progetto utilizzando la funzionalità Vai all'oggetto o al file. Fai clic sull'icona Vai all'oggetto o al file nel browser dei file o nel browser degli oggetti oppure utilizza la scorciatoia da tastiera Comando-J (Mac) o Ctrl+J (Windows).

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

Riquadro Guida rapida

Seleziona l'icona Guida rapida per aprire il riquadro Guida rapida, che fornisce spiegazioni e opzioni per la posizione corrente nel codice. Seleziona il nome di un parametro nella barra laterale per aprire la pagina della documentazione di Looker per quel parametro.

Riquadro Aiutami a programmare

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

IDE Looker con l'icona Aiutami a programmare evidenziata.

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

Menu delle opzioni per file e cartelle

Nel browser di file, ogni file o cartella nel riquadro laterale a sinistra ha un menu che mostra le azioni disponibili per quell'elemento. Tieni premuto il cursore su un file e una cartella, quindi seleziona il menu con tre puntini Opzioni cartella (per le cartelle) o il menu 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 saperne di più, consulta la pagina della documentazione sulla gestione di file e cartelle LookML.

Quando organizzi i file LookML con le cartelle, devi eseguire il commit delle modifiche ed eseguirne il deployment in produzione prima che altri sviluppatori di Looker possano vederle. È come qualsiasi modifica che apporti al tuo progetto LookML.

Ricerca e sostituzione di testo nel progetto

L'IDE di Looker ha una funzione Trova e sostituisci, che puoi utilizzare per cercare testo in tutti i file di progetto e poi sostituire tutte le istanze o quelle selezionate con un'operazione collettiva.

Per utilizzare la funzione di ricerca nell'IDE di Looker, segui questi passaggi:

  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. Facoltativamente, puoi lasciare vuoto il campo Sostituisci con se vuoi eliminare il testo nel campo Trova anziché sostituirlo.

  2. Seleziona Seleziona & Sostituisci per visualizzare l'anteprima di come verrà sostituito il 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à Yes se l'utente si trova in California o a New York, e No in caso contrario.

Il LookML per la nostra nuova dimensione ha il seguente aspetto:

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

Successivamente aggiungeremo una nuova misura alla vista user che calcola in media l'età dei nostri utenti. Questa misura sarà type: average e verrà aggregata nella colonna age.

Il LookML per questa nuova misura ha il seguente aspetto:

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

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

Test dei campi in Esplora

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 le azioni sul file elenca tutte le esplorazioni basate sulla visualizzazione, incluse le esplorazioni a cui è unita la vista. Ad esempio, per accedere a Esplora per una vista chiamata users, puoi selezionare l'opzione Esplora utenti dal menu a discesa Visualizza azioni su file.

In Esplora Utenti, puoi selezionare i nuovi campi per aggiungerli a una query. Ad esempio, puoi creare una query con entrambi i nuovi campi che mostrano l'età media degli utenti che vivono in California o di New York e l'età media degli utenti che non lo sono:

Tabella di dati per un'esplorazione degli utenti di esempio con i campi Utenti di Canada o New York (Sì/No) ed Età media degli utenti selezionati.