Generazione di un modello LookML

Questa pagina della documentazione descrive i passaggi per generare automaticamente un modello LookML di base dalla connessione al database utilizzando la pagina Crea un modello. La pagina Crea un modello può essere utilizzata anche per creare un progetto che ospiterà il modello.

Sono disponibili anche altre opzioni per la creazione di file modello:

  • Puoi creare manualmente file modello e altri file di progetto dall'IDE.

  • Puoi utilizzare il metodo legacy per creare progetti e generare modelli facendo clic su uno dei seguenti elementi, che ti indirizzano alla pagina legacy Nuovo progetto:

    • Il link nel banner nella parte superiore della pagina Crea un modello
    • il pulsante Aggiungi LookML nella sezione Progetti in attesa della pagina Progetti

    Una volta nella pagina Nuovo progetto, segui i passaggi descritti nella documentazione Creazione di un nuovo progetto LookML.

Accedere alla pagina Crea un modello

Accedi alla pagina Crea un modello nei seguenti modi:

Per accedere alla pagina Crea un modello, devi essere in modalità di sviluppo.

Per accedere alla pagina Crea un modello, devi essere un amministratore di Looker o disporre dell'autorizzazione develop.

Dalla sezione Sviluppa

Per accedere alla pagina Crea un modello dalla sezione Sviluppa, completa i seguenti passaggi.

  1. Fai clic su Sviluppa nel pannello di navigazione a sinistra.

  2. Seleziona Progetti dalla sezione Sviluppa nel pannello di navigazione.

  3. Questa selezione apre la pagina Progetti LookML. La pagina Progetti LookML ti consente di visualizzare tutti i progetti a cui hai accesso, insieme ai rispettivi modelli. Nella pagina Progetti LookML, seleziona il pulsante Nuovo modello per aprire la pagina Crea un modello.

Dal pulsante Crea

Per accedere alla pagina Crea un modello dal pulsante Crea, completa i seguenti passaggi.

  1. Dal menu di navigazione principale, fai clic sul pulsante Crea.
  2. Seleziona Modello LookML dal menu a discesa. Viene visualizzata la pagina Crea un modello.

Generare un modello

La pagina Crea un modello è suddivisa in sezioni. Per generare un modello, completa i passaggi nelle sezioni seguenti. Dopo ogni sezione, fai clic su Avanti per salvare l'input e passare alla sezione successiva.

  1. Seleziona connessione al database:

    • Seleziona connessione al database: seleziona una connessione al database dal menu a discesa. Puoi anche scegliere l'opzione Crea nuova connessione dal menu a discesa. Viene visualizzata la pagina Collega il database a Looker , dove puoi creare una nuova connessione.

    • Se hai accesso a progetti che utilizzano già la connessione, questi vengono visualizzati una volta selezionata la connessione. Puoi scegliere di aggiungere il nuovo modello a un progetto esistente disponibile oppure di creare un nuovo progetto LookML per il modello.

    • Nome progetto LookML: se vuoi creare un nuovo progetto LookML per il modello, inserisci un nome del progetto in questo campo. I nomi dei progetti fanno distinzione tra maiuscole e minuscole e consentono solo caratteri alfanumerici, _, . e -. Scegli con attenzione il nome del progetto e consideralo un ID permanente per il progetto. I nuovi progetti vengono configurati utilizzando un repository Git semplice.

    • Seleziona la casella di controllo Genera un file README che fornisca ulteriori informazioni sull'utilizzo di LookML se vuoi che Looker aggiunga un file README al nuovo progetto. Tale file README contiene un'introduzione a LookML, oltre a link e risorse utili ai nuovi sviluppatori LookML.

    • Fai clic sul pulsante Avanti per salvare le voci e passare alla sezione successiva.

  2. Seleziona tabelle:

    • Se utilizzi una connessione BigQuery, seleziona il Google Cloud progetto in cui risiede il set di dati dal menu a discesa Seleziona progetto Google Cloud o cerca il progetto nel campo Cerca nome progetto. Per impostazione predefinita, il progetto di archiviazione Google Cloud viene visualizzato nel menu a discesa, se esiste; in caso contrario, viene visualizzato il progetto di fatturazione Google Cloud .
    • Nella tabella, seleziona i set di dati (BigQuery) o gli schemi (altri dialetti) da utilizzare nel modello.
    • Una volta selezionati i set di dati o gli schemi, utilizza la freccia a destra di ogni nome di set di dati o schema per aprire la scheda Tabelle e selezionare ogni tabella da includere. Viste verranno create dalle tabelle.
    • Una volta selezionate le tabelle, utilizza la freccia a destra di ogni nome tabella per aprire la scheda Campi e selezionare ogni campo da includere.
    • Ignora prefissi: se vuoi ignorare i prefissi delle tabelle nei nomi dei file di vista generati, inserisci i prefissi del database in un elenco separato da virgole in questo campo. Questo campo distingue tra lettere maiuscole e minuscole. Puoi elencare più prefissi, separati da virgole. Ad esempio, le tabelle sono intitolate dwh_orders e DBS_users. Se inserisci dwh, DBS nel campo Ignora prefissi, Looker crea file di viste denominati orders e users.
    • Importa descrizioni dei campi: seleziona questa casella di controllo per utilizzare le descrizioni dei campi disponibili nel database come descrizioni LookML per le dimensioni generate.
    • Fai clic sul pulsante Avanti per salvare le voci e passare alla sezione successiva.

  3. Seleziona chiavi primarie:

    • Seleziona una chiave primaria per ogni tabella selezionata. Questa operazione consente a Looker di unire meglio le tabelle.
    • Questo passaggio è facoltativo; per saltarlo, non selezionare alcuna chiave primaria.
    • Fai clic sul pulsante Avanti per salvare le voci e passare alla sezione successiva.

  4. Seleziona esplorazioni da creare:

    • Seleziona ciascuna visualizzazione che vuoi utilizzare come base per un'Esplora. Per ciascuna visualizzazione selezionata, il sistema unisce automaticamente il maggior numero possibile di altre visualizzazioni. È possibile utilizzare in un join solo le visualizzazione con una chiave primaria identificata nel passaggio precedente.
    • Questo passaggio è facoltativo; per saltarlo, non selezionare alcuna visualizzazione.
    • Fai clic sul pulsante Avanti per salvare le voci e passare alla sezione successiva.

  5. Inserisci il nome del modello:

  6. Fai clic su uno dei seguenti pulsanti per generare i file modello e, se selezionato, il nuovo progetto:

    • Completa e visualizza modello: Looker ti indirizza ai file nell'IDE di Looker.
    • Completa ed esplora i dati: Looker ti indirizza all'esplorazione che corrisponde al primo file di vista selezionato nella sezione Seleziona esplorazioni da creare.

  7. Se hai creato un nuovo progetto e vuoi collegarlo a un repository diverso dal repository Git semplice utilizzato da Looker per la creazione del progetto, fai clic sul pulsante Reimposta connessione Git nella scheda Configurazione della pagina Impostazioni progetto del progetto per completare la procedura.

Quando è necessario configurare i modelli

La configurazione di un modello è utile per i seguenti motivi:

  • Specifica che un determinato nome modello si riferisce a un modello specifico in un progetto specifico.
  • Imposta le connessioni che il modello può utilizzare.

Non è necessaria una configurazione del modello per gli amministratori (o gli sviluppatori con l'autorizzazione manage_models o manage_project_models) quando sono in modalità di sviluppo. In questo modo, gli sviluppatori LookML possono lavorare in modalità di sviluppo. Tuttavia, se esiste una configurazione del modello, le query sono vincolate da questa configurazione anche in modalità di sviluppo.

Anche se uno sviluppatore LookML specifica la connessione prevista nel file modello, un amministratore controlla le connessioni consentite nella pagina Progetti LookML. Se un modello specifica l'utilizzo di una connessione non consentita nella configurazione del modello, la connessione non è consentita.

Un modello deve avere una configurazione nei seguenti scenari:

  • Quando un modello viene inviato in produzione per la prima volta. Se il modello non è configurato, tutte le query sul modello non vanno a buon fine una volta che il modello è in modalità di produzione. Quando un modello viene inviato dalla modalità di sviluppo alla produzione per la prima volta, Looker lo configura automaticamente se il nome del modello è univoco per l'istanza di Looker. Tuttavia, se hai un modello configurato con lo stesso nome in un altro progetto, Looker non lo configura automaticamente.
  • Durante lo sviluppo. Se hai sviluppatori a cui non è stata concessa l'autorizzazione manage_models (inclusa nel ruolo admin) o l'autorizzazione manage_project_models, il modello deve essere configurato prima che questi sviluppatori possano eseguire query sul modello. Puoi configurare il modello prima che esista o prima che esista il progetto. Poi, quando uno sviluppatore LookML crea il modello, le connessioni consentite del modello sono già configurate e lo sviluppatore può eseguire le query correttamente.

Looker consente agli sviluppatori che dispongono dell'autorizzazione manage_models o manage_project_models di eseguire query su un modello non configurato in modalità di sviluppo. Looker esegue questa operazione cercando nei progetti un modello con quel nome. Per eseguire la query viene utilizzato il primo modello trovato con quel nome.

Configurare i modelli pianificati

Il pulsante Configura nuovo modello nella parte superiore della pagina Progetti LookML può essere utilizzato dagli amministratori di Looker per aggiungere una configurazione a un modello esistente o a un modello pianificato che non esiste ancora.

La configurazione anticipata di un modello è utile se agli sviluppatori non è stata concessa l'autorizzazione manage_models o l'autorizzazione manage_project_models. Se un amministratore configura il file del modello per gli sviluppatori, questi potranno eseguire query non appena generano o creano il file del modello.

Gli amministratori possono anche specificare le connessioni ai database che possono essere utilizzate dal modello oppure possono specificare che il modello può utilizzare tutte le connessioni attuali o future. Gli sviluppatori Looker utilizzano il parametro LookML connection per specificare nel file modello la connessione che il modello deve utilizzare. Se uno sviluppatore specifica una connessione non consentita da un amministratore nella configurazione del modello, non verrà eseguita alcuna query sul modello.

Quando un amministratore configura in anticipo un nuovo modello e crea un nuovo progetto nell'ambito della configurazione, il progetto viene visualizzato nella sezione Progetti in attesa della pagina Progetti.

Generare un progetto vuoto

La creazione di un progetto vuoto può essere utile quando vuoi creare i file LookML da zero.

La pagina Crea un modello genera progetti con file LookML inclusi. Tuttavia, puoi ridurre al minimo i file LookML generati completando solo le seguenti sezioni nella pagina Crea un modello:

  • Seleziona connessione al database
  • Seleziona tabelle
  • Inserisci il nome del modello

Lascia le sezioni rimanenti non completate.

Fai clic sul pulsante Completa e visualizza modello, che ti indirizza al progetto nell'IDE di Looker. Una volta nell'IDE, puoi eliminare tutti i file LookML che non ti interessano per creare un progetto vuoto.

Passaggi successivi

Dopo aver creato un modello o un progetto, puoi eseguire le seguenti azioni: