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 saperne di più sui progetti, puoi consultare le pagine Progetti e modello di sviluppo di LookML e Terminologia e concetti di LookML nella documentazione. Per 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 modello. Se tuttavia desideri specificare le autorizzazioni utente relative alla visualizzazione e alla modifica di uno specifico file modello 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 Sviluppa 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 può creare un progetto in diversi modi e i passaggi da seguire dipendono dall'opzione Punto di partenza che scegli nella pagina Nuovo progetto. Il funzionamento dei punti di partenza viene illustrato nelle sezioni successive:

Generazione automatica di un modello dal tuo 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 sono sensibili alle maiuscole 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.
    • Nell'ambito dell'URL dei file di progetto. Ad esempio, in un'istanza di Looker con un URL example.looker.com, il file manifest del progetto per il progetto denominato ecommerce si trova a questo 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. Genera 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 di 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 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 hanno i titoli dwh_orders e DBS_users. Se inserisci dwh, DBS nel campo di testo Ignora prefissi, Looker crea file di visualizzazione denominati orders e users.

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

  • Il generatore LookML crea un solo file modello per il progetto e un file di vista per ciascuna tabella nel database (salvo diversa indicazione). Poi, 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 nel nuovo progetto LookML.

I progetti Looker clonati da repository Git pubblici dalla pagina Nuovo progetto sono di sola lettura. Tuttavia, puoi importare il progetto di sola lettura in un altro progetto Looker, dove puoi utilizzare i file del repository clonato come punto di partenza per i extends o i miglioramenti di Looker per creare un progetto da lì.

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

  1. Verifica di essere in modalità di sviluppo.
  2. Nella 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 contenere 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.
    • Nell'ambito dell'URL dei file di progetto. Ad esempio, in un'istanza di Looker con un URL example.looker.com, il file manifest del progetto per il progetto denominato ecommerce si trova a questo URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. Per il 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 git://github.com/example/my-repository.git.

    Se hai un URL come https://github.com/llooker/blocks_redshift_admin, puoi modificarlo nel formato corretto sostituendo https:// con git:// e aggiungendo .git alla fine. L'URL che dovresti inserire è git://github.com/llooker/blocks_redshift_admin.git.

  7. Fai clic su Crea progetto. Looker estrae tutti i file del repository pubblico in un nuovo progetto LookML e lo apre nell'IDE di Looker.

Metodo alternativo per clonare un repository Git pubblico

Il modo più semplice per clonare un repository Git pubblico è clonarlo utilizzando la pagina Nuovo progetto in Looker. Tuttavia, la clonazione dalla pagina Nuovo progetto presenta due svantaggi:

  • GitHub non supporta gli URL git://, quindi non puoi clonare i repository GitHub dalla pagina Nuovi progetti.
  • I repository Git clonati dalla pagina Nuovi progetti sono di sola lettura.

Se hai un repository GitHub o vuoi poter scrivere nel tuo repository, puoi invece eseguire il fork del repository e connetterlo 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 e poi utilizzare il controllo della versione e implementare le modifiche nell'ambiente di produzione come per qualsiasi progetto LookML standard.

Creare 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. Nella 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 sono sensibili alle maiuscole e non possono contenere 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.
    • Nell'ambito dell'URL dei file di progetto. Ad esempio, in un'istanza di Looker con un URL example.looker.com, il file manifest del progetto per il progetto denominato ecommerce si trova a questo URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. Per il 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: