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.

Esistono anche altre opzioni per creare file di modello:

  • Puoi creare manualmente i file di 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 pulsanti, che ti reindirizzano 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 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. Nel menu di navigazione principale, fai clic sul pulsante Crea.
  2. Seleziona Modello LookML dal menu a discesa. Si aprirà la pagina Crea un modello.

Generazione di un modello

La pagina Crea un modello è suddivisa in sezioni. Per generare un modello, completa i passaggi descritti nelle sezioni seguenti. Dopo ogni sezione, fai clic su Avanti per salvare i dati inseriti 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. Si apre la pagina Connetti il database a Looker, in cui 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 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 sono sensibili alle maiuscole 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 bare.

    • 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. Il 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 progetto Google Cloud in cui si trova 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. Verranno create viste dalle tabelle.
    • Una volta selezionate le tabelle, utilizza la freccia a destra di ogni nome di tabella per aprire la scheda Campi e seleziona ogni campo da includere.
    • Ignora prefissi: se vuoi ignorare i prefissi della tabella 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 hanno i titoli dwh_orders e DBS_users. Se inserisci dwh, DBS nel campo Ignora prefissi, Looker crea file di visualizzazione 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'esplorazione. 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 del modello e, se selezionato, il nuovo progetto:

    • Completa e visualizza il modello: Looker ti porta ai file nell'IDE di Looker.
    • Completa ed esplora i dati: Looker ti porta all'esplorazione corrispondente al primo file di visualizzazione selezionato nella sezione Seleziona esplorazioni da creare.

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

Quando devi configurare i modelli

Configurare un modello è utile per i seguenti motivi:

  • Specifica che un determinato nome del modello si riferisce a un modello specifico in un progetto specifico.
  • Definisce 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) mentre sono in modalità di sviluppo. In questo modo, gli sviluppatori LookML possono lavorare in modalità di sviluppo. Tuttavia, se esiste una configurazione del modello, qualsiasi query è vincolata da questa configurazione anche in modalità Development (Sviluppo).

Anche se uno sviluppatore LookML specifica la connessione prevista nel file del 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à Production (Produzione). Quando un modello viene spostato 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 configurato un modello 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. In questo modo, quando uno sviluppatore LookML crea il modello, le connessioni consentite del modello sono già configurate e lo sviluppatore può eseguire 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à Development (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.

Configurazione dei 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 per un modello esistente o per un modello pianificato che non esiste ancora.

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

Gli amministratori possono anche specificare quali connessioni ai database possono essere utilizzate dal modello oppure possono specificare che il modello può utilizzare qualsiasi connessione attuale o futura. Gli sviluppatori di Looker utilizzano il parametro LookML connection per specificare nel file del modello la connessione che deve essere utilizzata. Se uno sviluppatore specifica una connessione che un amministratore non ha consentito nella configurazione del modello, qualsiasi query sul modello non verrà eseguita.

Quando un amministratore configura in anticipo un nuovo modello e crea un nuovo progetto nell'ambito di questa 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 tuoi 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 incomplete.

Fai clic sul pulsante Completa e visualizza modello, che ti reindirizza 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: