Generazione di un modello

Questa pagina fornisce i passaggi per creare un nuovo progetto e generare automaticamente un modello base dal tuo database.

Esistono altre opzioni per la creazione di file di progetto: puoi creare un progetto vuoto e creare manualmente il relativo modello oppure clonare un repository Git pubblico esistente. Consulta la pagina della documentazione Creazione di un nuovo progetto LookML.

Generazione automatica di un modello a partire dal tuo database

  1. Fai clic su Sviluppo nella barra dei menu e verifica di essere in modalità di sviluppo.

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

  3. Dalla pagina Progetti LookML, seleziona Nuovo progetto LookML:

    • La pagina Progetti LookML ti consente di visualizzare tutti i tuoi progetti insieme ai rispettivi modelli. Utilizza questa pagina per creare, visualizzare e configurare i tuoi progetti.

  4. Nella finestra di dialogo Nuovo progetto, specifica le opzioni per il progetto:

    • Assegna un nome al progetto.
    • In Punto di partenza, scegli Genera modello da schema del database.
    • Dal menu a discesa Connessione, seleziona il nome della connessione al tuo database.
    • In Crea visualizzazioni da, seleziona un'opzione:
      • Tutte le tabelle. Il generatore LookML crea un file di vista per ogni tabella presente nel tuo database.
      • Tabella singola: il generatore LookML crea una vista per una sola tabella del tuo database. Se scegli questa opzione, inserisci il nome della tabella di database.
    • Per generare file per un solo schema nel tuo database, inserisci il nome di tale schema nel campo di testo Schemi. Puoi elencare più schemi, separati da virgole.
    • Per escludere i prefissi delle tabelle dai nomi file dei viste, inserisci i prefissi del database nel campo di testo Ignora prefissi. Questo campo distingue tra lettere maiuscole e minuscole. Puoi elencare più prefissi, separati da virgole. Ad esempio, le tabelle sono chiamate dwh_orders e DBS_users. Se inserisci dwh, DBS nel campo di testo Ignora prefissi, Looker crea i file di visualizzazione denominati orders e users.
  5. Fai clic su Crea progetto.

    • Il generatore LookML crea un file di modello per il progetto e un file di vista per ogni tabella nel database (se non diversamente specificato). Quindi, Looker apre il nuovo progetto nell'IDE di Looker.
    • Il generatore LookML crea cartelle dell'IDE per i file della vista e del modello. Se il tuo database include più di uno schema, il generatore LookML crea una cartella per gli schemi.

Per le connessioni BigQuery, se generi un progetto LookML a partire dal tuo database, Looker popola automaticamente le descrizioni dei campi con le descrizioni dei metadati delle colonne di BigQuery, se disponibili.

Il generatore crea inoltre un'esplorazione per ogni tabella del database. Per iniziare a eseguire query sui dati, puoi utilizzare il riquadro Esplora per selezionare il nome di un'esplorazione.

Per rinominare il progetto dopo averlo creato, consulta la sezione Rinominare un progetto nella pagina della documentazione Accesso e modifica delle informazioni del progetto.

Puoi creare manualmente nuovi modelli per il tuo progetto come descritto nella pagina Informazioni sui modelli e sulla visualizzazione dei file, configurarli per l'utilizzo in produzione come descritto nella sezione Quando è necessario configurare i modelli in questa pagina e trovare ulteriori istruzioni nella pagina della documentazione Creare un nuovo progetto LookML.

Dopo aver generato o creato manualmente i file modello, consulta la pagina della documentazione relativa a configurazione e test di una connessione Git per informazioni sulla connessione del tuo progetto Looker a Git. Puoi registrare le modifiche apportate ai file LookML e gestire le versioni dei file.

Generazione LookML migliorata

Se l'amministratore Looker ha abilitato la funzionalità di Labs Better LookML Generation, quando generi il progetto dal tuo database Looker vi aggiunge ulteriori elementi:

  • Looker aggiunge un file README al nuovo progetto. Il file README contiene un'introduzione a LookML, oltre a link e risorse utili ai nuovi sviluppatori LookML.
  • Looker aggiunge varie spiegazioni per i commenti in linea al file del modello e a ogni file della vista.
  • Se una vista ha almeno una dimensione type: number che non contiene la stringa id nel nome, Looker crea una misura di type: sum e una misura di type: average, entrambe basate sulla prima dimensione in ordine alfabetico di type: number che non contiene la stringa id nel nome.

Quando è necessario configurare i modelli

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

  • Specifica che un determinato nome di modello si riferisce a un particolare modello in un determinato progetto.
  • 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) che si trovano in modalità di sviluppo. In questo modo gli sviluppatori LookML possono lavorare facilmente in modalità di sviluppo. Tuttavia, se esiste una configurazione del modello, tutte le query sono vincolate da quella configurazione anche in modalità di sviluppo.

Sebbene uno sviluppatore LookML specifichi la connessione desiderata nel file del modello, un amministratore controlla quali connessioni sono 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, una volta che il modello è in modalità di produzione le query su quel modello avranno esito negativo. Quando un modello viene caricato dalla modalità di sviluppo alla produzione per la prima volta, Looker lo configura automaticamente se il suo nome è 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), il modello deve essere configurato prima che gli sviluppatori possano eseguire query su quel modello. Puoi configurare il modello prima dell'esistenza del modello o prima dell'esistenza del progetto. Quindi, quando uno sviluppatore LookML crea il progetto e il modello, le connessioni consentite nel modello sono già configurate e lo sviluppatore può eseguire le query correttamente.

Looker consente agli sviluppatori con l'autorizzazione manage_models di eseguire query su un modello non configurato in modalità di sviluppo. Per farlo, Looker cerca nei modelli un modello con quel nome. Il primo modello trovato con quel nome viene utilizzato per eseguire la query.