Generazione di un modello LookML

Questa pagina di 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 la creazione di file di modello:

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

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

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

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

Accesso alla pagina Crea un modello

Puoi accedere 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. Nel menu di navigazione principale, fai clic sul pulsante Crea.
  2. Seleziona Modello LookML dal menu a discesa. Viene visualizzata 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. Viene visualizzata 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 dopo la selezione della connessione. Puoi scegliere di aggiungere il nuovo modello a un progetto esistente disponibile o 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 in questo campo. I nomi dei progetti sono sensibili alle maiuscole e consentono solo caratteri alfanumerici, _, . e -. Scegli attentamente 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, nel menu a discesa viene visualizzato il progetto di archiviazione Google Cloud, se esistente. 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 del nome di ciascun set di dati o schema per aprire la scheda Tables (Tabelle) e selezionare ogni tabella da includere. Verranno create visualizzazioni 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 delle tabelle nei nomi dei file delle viste generate, 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 denominate 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 le chiavi principali.
    • 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 reindirizza ai file nell'IDE di Looker.
    • Completa ed esplora i dati: Looker ti reindirizza all'esplorazione corrispondente al primo file di visualizzazione selezionato nella sezione Seleziona le esplorazioni da creare.

  7. Se hai creato un nuovo progetto e vuoi collegarlo 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 del progetto per completare la procedura.

Quando devi configurare i modelli

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

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

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

Sebbene uno sviluppatore LookML specifichi la connessione prevista nel file del modello, è un amministratore a controllare 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 su quel modello non andranno a buon fine quando il modello è in modalità di produzione. Quando un modello viene trasferito 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 a uno o più sviluppatori 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 su di esso. Puoi configurare il modello prima che esista o prima che esista il progetto. 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à di sviluppo. Per farlo, Looker cerca un modello con quel nome nei progetti. 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 di un modello in anticipo è utile se agli sviluppatori non è stata concessa 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 connection di LookML per specificare nel file del modello quale connessione deve essere utilizzata. Se uno sviluppatore specifica una connessione non consentita da un amministratore nella configurazione del modello, nessuna query su quel modello 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.

Generazione di 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 i 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 il modello per accedere al progetto nell'IDE di Looker. Una volta nell'IDE, puoi eliminare 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: