Generazione di un modello

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

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

Generazione automatica di un modello dal database

Puoi generare automaticamente un modello dal tuo database nella sezione Sviluppa di Looker o utilizzando il pulsante Crea nel riquadro di navigazione a sinistra.

Generare un modello dalla sezione Sviluppo

  1. Fai clic su Sviluppo nel riquadro di navigazione a sinistra e verifica di essere in modalità di sviluppo.

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

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

    • La pagina Progetti LookML ti consente di visualizzare tutti i tuoi progetti e i relativi modelli. Puoi utilizzare questa pagina per creare, visualizzare e configurare i tuoi progetti.

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

    • Nome progetto: assegna un nome al progetto. Scegli il nome del progetto con attenzione e consideralo un ID permanente per il progetto, poiché Looker utilizza il nome del progetto nei seguenti modi:

      • Per identificare il progetto per le chiamate API che hanno il parametro project_id.
      • Per identificare il progetto nel database interno dell'istanza di Looker.
      • Per identificare il progetto per l'importazione del progetto locale.
      • Per visualizzare il progetto nella pagina Progetti LookML.
      • Per visualizzare il progetto nella sezione Sviluppa del pannello di navigazione di Looker.
      • Come parte dell'URL dei file di progetto. Ad esempio, in un'istanza di Looker con URL example.looker.com, il file manifest del progetto denominato ecommerce è disponibile all'URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

    • Punto di partenza: scegli Genera modello da schema database.

    • Connessione: dal menu a discesa, seleziona il nome della connessione al database.

    • Genera viste da: seleziona una delle seguenti opzioni:

      • Tutte le tabelle: il generatore LookML crea un file di vista per ogni tabella nel database.
      • Tabella singola: il generatore LookML crea una vista per una tabella nel tuo database. Se scegli questa opzione, inserisci il nome della tabella di database.

    • Schemi: per generare file per un solo schema nel database, inserisci il nome dello schema nel campo di testo Schemi. Puoi elencare più schemi, separati da virgole.

    • Ignora prefissi: per escludere i prefissi delle tabelle dai nomi dei file delle viste, inserisci i prefissi del database nel campo Ignora prefissi. 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 di testo Ignora prefissi, Looker crea dei file di viste denominati orders e users.

  5. Fai clic su Crea progetto.

    • Il generatore LookML crea un file modello per il progetto e un file di vista per ogni tabella nel database (salvo diversa indicazione). Quindi, Looker apre il nuovo progetto nell'IDE di Looker.
    • Il generatore LookML crea cartelle IDE per i file di viste e modelli. 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, utilizza il riquadro Esplora per selezionare il nome di un'esplorazione.

Per rinominare un progetto dopo averlo creato, consulta la sezione Ridenominazione di un progetto della pagina della documentazione Consultazione e modifica delle informazioni sui progetti.

Puoi creare manualmente altri nuovi modelli per il tuo progetto come descritto nella pagina della documentazione Informazioni sui file di modello e visualizzazione, configurarli per l'utilizzo in produzione come descritto nella sezione Quando devi configurare i modelli di questa pagina e trovare ulteriori istruzioni nella pagina della documentazione Creazione di un nuovo progetto LookML.

Dopo che i file del modello sono stati generati o creati manualmente, consulta la pagina della documentazione Configurazione e test di una connessione Git per informazioni sulla connessione del tuo progetto Looker a Git. Puoi registrare le modifiche ai file LookML e gestire le versioni dei file.

Generare un modello utilizzando il pulsante Crea.

Per creare un progetto e generare un modello utilizzando il pulsante Crea, segui questi passaggi:

  1. Fai clic sul pulsante Crea nel pannello di navigazione a sinistra.
  2. Seleziona l'opzione di menu Modello LookML.
  3. Verifica di essere in modalità di sviluppo.
  4. In modalità di sviluppo, viene visualizzata la pagina Crea un progetto.
  5. Se vuoi selezionare le viste di base per le esplorazioni o personalizzare altre opzioni avanzate come l'ignorare i prefissi delle tabelle nei nomi dei file delle viste generate, importare i metadati della descrizione dei campi dal database, determinare la creazione del file del modello e selezionare i file readme generati automaticamente, attiva l'opzione Creazione di progetti avanzata.
  6. Seleziona una connessione al database dal menu a discesa Seleziona connessione al database. Se hai accesso a progetti che utilizzano già la connessione, questi verranno visualizzati una volta selezionata la connessione. Puoi scegliere di utilizzare un progetto disponibile a cui aggiungere un nuovo modello o crearne uno nuovo. Se scegli di aggiungere il modello a un progetto, viene visualizzata la sezione Crea modello come primo passaggio nella pagina Crea un progetto, in cui puoi assegnare un nome al modello. Dopo aver effettuato le selezioni, fai clic su Avanti.
  7. Nella sezione Seleziona dati, seleziona gli schemi, le tabelle e i campi da utilizzare nel modello. Le viste verranno create dalle tabelle. Dopo aver effettuato le selezioni, fai clic su Avanti.
  8. Seleziona una chiave primaria per ogni tabella. Questa operazione consente a Looker di unire meglio le tabelle. Dopo aver effettuato le selezioni, fai clic su Avanti.
  9. Se hai abilitato l'opzione Creazione avanzata di progetti, seleziona le viste di base per Esplorazioni. Seleziona ogni vista 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. Dopo aver effettuato le selezioni, fai clic su Avanti.
  10. Se hai abilitato l'opzione Creazione avanzata di progetti, effettua le seguenti selezioni nella sezione Opzioni avanzate:
    • Ignora prefissi: per ignorare i prefissi della tabella 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 intitolate dwh_orders e DBS_users. Se inserisci dwh, DBS nel campo di testo Ignora prefissi, Looker crea file di visualizzazione denominati orders e users.
    • Descrizioni dei campi: seleziona la casella di controllo Importa metadati descrizione campo per utilizzare le descrizioni dei campi disponibili nel database come descrizioni LookML per le dimensioni generate.
    • Gestione dei file del modello: scegli se creare o meno un file del modello. Se scegli di creare un file modello, inserisci il nome che vuoi assegnare al file nel campo Nome modello.
    • Guida introduttiva - Seleziona la casella di controllo Genera un file Leggimi che descriva come utilizzare l'output per generare un file Leggimi che descriva come utilizzare il progetto.
  11. Fai clic su Genera modello per generare i file del progetto. Una volta generati, i file vengono visualizzati nell'IDE di Looker.

Generazione LookML migliorata

Se l'amministratore di Looker ha attivato la funzionalità di Labs Generare LookML migliorato, quando generi il progetto dal database, Looker aggiunge elementi aggiuntivi:

  • Looker aggiunge un file README al nuovo progetto. Il file README contiene un'introduzione a LookML, oltre a link e risorse per aiutare i nuovi sviluppatori di LookML.
  • Looker aggiunge diverse spiegazioni di commenti incorporate al file del modello e a ogni file della vista.
  • Se una visualizzazione ha almeno una dimensione di 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 alfabeticamente di type: number che non contiene la stringa id nel nome.

Quando devi configurare i modelli

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

  • Specifica che un determinato nome di modello fa riferimento a un particolare modello in un particolare 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, le eventuali query sono vincolate da tale 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 sua configurazione, allora la connessione non è consentita.

Un modello deve avere una configurazione nei seguenti scenari:

  • Quando un modello viene messo in produzione per la prima volta. Se il modello non è configurato, le query su quel modello avranno esito negativo quando il modello è in modalità Produzione. Quando un modello viene trasferito 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 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 che esista il progetto. Quando uno sviluppatore LookML crea il progetto e 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. Il primo modello trovato con questo nome viene utilizzato per eseguire la query.