Creazione di un nuovo progetto LookML

Un progetto è una raccolta di file LookML che descrivono le relazioni esistenti fra le tabelle del tuo database e il modo in cui devono essere interpretate da Looker. Per ulteriori informazioni sui progetti, puoi consultare le pagine Progetti e modello di sviluppo di LookML e Terminologia e concetti di LookML nella documentazione. Per ulteriori informazioni sull'accesso e sulla modifica dei progetti esistenti, consulta la pagina della documentazione Consultazione e modifica delle informazioni sui progetti.

Un progetto LookML può contenere più di un file del modello. Se tuttavia desideri specificare le autorizzazioni utente relative alla visualizzazione e alla modifica di un file modello specifico in LookML, è consigliabile creare un nuovo progetto. Anche se in Looker la maggior parte delle autorizzazioni viene applicata a livello di modello, alcune autorizzazioni vengono applicate a livello di progetto, come avviene ad esempio per see_lookml, che consente di visualizzare LookML per un progetto, e develop, che consente di modificare il codice LookML.

Gli utenti di Looker con l'autorizzazione manage_models possono creare modelli LookML in un'istanza di Looker.

Creazione di un progetto

Per creare un progetto:

  1. Verifica di essere in modalità di sviluppo.

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

  3. Nella pagina Progetti LookML, seleziona Nuovo progetto LookML per selezionare le opzioni per il tuo progetto.

Questa azione apre la pagina Nuovo progetto, in cui puoi specificare le impostazioni del progetto, inclusi il nome e il punto di partenza.

Looker offre varie modalità di creazione dei progetti, pertanto i passi da seguire dipendono dall'opzione Punto di partenza che selezioni nella pagina Nuovo progetto. Il funzionamento dei punti di partenza viene illustrato nelle sezioni successive:

Generazione automatica di un modello dal database

Nella pagina Nuovo progetto, specifica le seguenti opzioni per generare automaticamente un modello da un database.

  1. Nome progetto: assegna un nome al progetto. I nomi dei progetti fanno distinzione tra maiuscole e minuscole e consentono solo caratteri alfanumerici, _, . e -. Scegli con attenzione il nome del progetto e consideralo un ID permanente per il progetto, poiché Looker lo utilizza 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 di progetti locali.
    • 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, in un'istanza di Looker con un URL example.looker.com, il file manifest del progetto denominato ecommerce è disponibile all'URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

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

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

  4. Crea viste da: seleziona una delle seguenti opzioni:

    • 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 del database.

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

  6. Ignora prefissi: per escludere i prefissi delle tabelle dai nomi dei file di vista, 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, i titoli delle tue tabelle sono dwh_orders e DBS_users. Se inserisci dwh, DBS nel campo di testo Ignora prefissi, Looker crea file di vista denominati orders e users.

Infine, fai clic su Crea progetto per creare un progetto che contenga il modello generato.

  • Il generatore LookML crea un file del modello per il progetto e un file di vista per ciascuna tabella nel database (salvo diversa indicazione). Quindi, Looker apre il nuovo progetto nell'IDE di Looker.
  • Il generatore LookML crea le cartelle dell'IDE per i tuoi 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.

Clonazione di un repository Git pubblico dalla pagina Nuovo progetto

Se selezioni Clona repository Git pubblico come punto di partenza dalla pagina Nuovo progetto, Looker copia i file da un repository Git pubblico in un nuovo progetto LookML.

Looker supporta la clonazione di un repository Git pubblico utilizzando l'URL web HTTPS del repository.

Per clonare un repository Git pubblico esistente in un progetto Looker:

  1. Verifica di essere in modalità di sviluppo.
  2. Dalla sezione Sviluppo del pannello di navigazione di Looker, seleziona Progetti.

  3. Nella pagina Progetti LookML, a seconda della configurazione dell'istanza, esegui una delle seguenti operazioni:

    • Fai clic sul pulsante Nuovo progetto LookML per aprire la pagina Nuovo progetto.
    • Fai clic sul pulsante Nuovo modello per aprire la pagina Crea un modello , quindi fai clic sul link fai clic qui nel banner informativo della pagina Crea un modello per aprire la pagina Nuovo progetto.

  4. Nel campo Nome progetto, assegna un nome al progetto. I nomi dei progetti fanno distinzione tra maiuscole e minuscole e non possono utilizzare spazi o determinati caratteri speciali. Scegli con attenzione il nome del progetto e consideralo un ID permanente per il progetto, poiché Looker lo utilizza 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 di progetti locali.
    • 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, in un'istanza di Looker con un URL example.looker.com, il file manifest del progetto denominato ecommerce è disponibile all'URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. Nel campo Punto di partenza, seleziona Clona repository Git pubblico.

  6. Nel campo URL repository Git, inserisci l'URL del repository Git pubblico. Assicurati che l'URL sia nel formato https://github.com/example/my-repository.git.

  7. Fai clic su Crea progetto. Looker clona il repository e apre l'IDE di Looker nel nuovo progetto LookML con i file di progetto del repository clonato.

Dopo che Looker ha creato il nuovo progetto LookML, devi configurare il controllo della versione Git connettendoti a un repository Git. Consulta la pagina Configurazione e test della connessione Git nella documentazione per le procedure di connessione a Git tramite HTTPS o SSH.

A seconda della situazione, potresti voler configurare la connessione Git per eseguire il push delle modifiche nel tuo repository Git oppure potresti voler eseguire il push delle modifiche nel repository Git originale clonato:

  • Se vuoi utilizzare i file clonati come punto di partenza per il tuo progetto indipendente dal repository Git pubblico, configura la connessione Git del progetto in modo che punti al tuo repository Git ed esegui il push delle modifiche.
  • Se vuoi contribuire con gli aggiornamenti al repository Git pubblico che hai clonato e hai un token di accesso personale con accesso in lettura/scrittura al repository pubblico, configura la connessione Git del progetto in modo che punti al repository Git pubblico ed esegui il push delle modifiche.

Dopo aver configurato la connessione Git a un repository, puoi modificare i file nell’IDE di Looker, quindi utilizzare il controllo della versione e implementare le modifiche in produzione come per qualsiasi progetto LookML standard.

Metodo alternativo per clonare un repository Git pubblico

Il modo più semplice per clonare un repository Git pubblico è utilizzare la pagina Nuovo progetto in Looker.

In alternativa, puoi creare un fork del repository e collegarlo a un progetto vuoto in Looker seguendo questi passaggi:

  1. Vai al tuo provider Git e crea un fork del repository.
  2. In Looker, crea un progetto vuoto come descritto nella sezione Creazione di un progetto vuoto di questa pagina.
  3. Dopo aver creato il nuovo progetto LookML vuoto, configura la connessione Git del progetto al fork del repository Git utilizzando HTTPS o SSH.

Dopo aver configurato la connessione Git al fork del repository, puoi modificare i file nell’IDE di Looker, quindi utilizzare il controllo della versione e implementare le modifiche in produzione come per qualsiasi progetto LookML standard.

Creazione di un progetto vuoto

Se selezioni Progetto vuoto come punto di partenza dalla pagina Nuovo progetto, Looker crea un progetto vuoto in modo che tu possa creare i file LookML da zero.

Per creare un progetto vuoto:

  1. Verifica di essere in modalità di sviluppo.
  2. Dalla sezione Sviluppo del pannello di navigazione di Looker, seleziona Progetti.

  3. Nella pagina Progetti LookML, a seconda della configurazione dell'istanza, esegui una delle seguenti operazioni:

    • Fai clic sul pulsante Nuovo progetto LookML per aprire la pagina Nuovo progetto.
    • Fai clic sul pulsante Nuovo modello per aprire la pagina Crea un modello , quindi fai clic sul link fai clic qui nel banner informativo della pagina Crea un modello per aprire la pagina Nuovo progetto.

  4. Nel campo Nome progetto, assegna un nome al progetto. I nomi dei progetti fanno distinzione tra maiuscole e minuscole e non possono utilizzare spazi o determinati caratteri speciali. Scegli con attenzione il nome del progetto e consideralo un ID permanente per il progetto, poiché Looker lo utilizza 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 di progetti locali.
    • 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, in un'istanza di Looker con un URL example.looker.com, il file manifest del progetto denominato ecommerce è disponibile all'URL https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. Nel campo Punto di partenza, scegli Progetto vuoto.

  6. Fai clic su Crea progetto. Looker crea il progetto e lo apre nell'IDE di Looker.

Passaggi successivi

Dopo aver creato un progetto, puoi: