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 creare i 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 dal database

  1. Fai clic su Sviluppo nella barra dei menu 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 insieme ai rispettivi 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.
      • Identificare il progetto nel database interno dell'istanza di Looker.
      • Identificare il progetto per l'importazione del progetto locale.
      • Per visualizzare il progetto nella pagina Progetti LookML.
      • Per visualizzare il progetto nella sezione Sviluppo del pannello di navigazione di Looker.
      • Come parte dell'URL dei file di progetto. Ad esempio, su un'istanza di Looker con l'URL example.looker.com, il file manifest del progetto denominato ecommerce è disponibile a questo URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

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

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

    • Crea visualizzazioni 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 del 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 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 IDE per i file delle viste e dei modelli. Se il database ha più di uno schema, il generatore LookML crea una cartella per gli schemi.

Per le connessioni BigQuery, se generi un progetto LookML dal tuo database, Looker compila automaticamente le descrizioni dei campi con le descrizioni provenienti dagli eventuali metadati della colonna BigQuery.

Il generatore crea anche un'esplorazione per ogni tabella di database. Per iniziare a eseguire query sui dati, utilizza 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 sul progetto.

Puoi creare manualmente nuovi modelli aggiuntivi per il tuo progetto come descritto nella pagina della documentazione Informazioni sul modello e sui file di visualizzazione, configurarli per l'utilizzo in produzione come descritto nella sezione Quando è necessario 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 relative versioni.

Generazione LookML migliorata

Se l'amministratore di Looker ha abilitato la funzionalità Labs Generazione LookML migliorata, Looker aggiunge ulteriori elementi al progetto quando lo generi dal database:

  • 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 vista 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 in ordine alfabetico 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.

Per gli amministratori (o gli sviluppatori con l'autorizzazione manage_models o manage_project_models) non è necessaria la configurazione del modello 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, le eventuali query sono vincolate da tale configurazione anche in modalità di sviluppo.

Anche se uno sviluppatore LookML specifica la connessione prevista 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 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 configurato un modello con lo stesso nome in un altro progetto, Looker non configura automaticamente il modello.
  • Durante lo sviluppo. Se hai sviluppatori a cui non è stata concessa l'autorizzazione manage_models (che è inclusa nel ruolo admin) o l'autorizzazione manage_project_models, il modello deve essere configurato prima che questi sviluppatori possano eseguire query su quel modello. 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 correttamente le query.

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.