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 scoprire di più sui progetti, consulta le pagine di documentazione Progetti e modello di sviluppo di LookML e Terminologia e concetti di LookML. 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 la maggior parte delle autorizzazioni in Looker si applica a livello di modello, alcune si applicano a livello di progetto, come ad esempio see_lookml, che consente di visualizzare il codice LookML per un progetto, e develop, che consente di modificarlo.

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, svolgi i seguenti passaggi:

  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, tra cui 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. Project Name (Nome progetto): assegna un nome al progetto. I nomi dei progetti sono sensibili alle maiuscole e consentono solo caratteri alfanumerici, _, . e -. 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.
    • Nell'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.

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

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

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

    • Tutte le tabelle: il generatore LookML crea un file di vista per ogni tabella del 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 sono denominate 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 contenente il modello generato.

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

Clonazione di un repository Git pubblico

Se selezioni Clona repository Git pubblico come punto di partenza, Looker copierà i file da un repository Git pubblico nel nuovo progetto LookML.

I progetti Looker clonati da repository Git pubblici sono di sola lettura. Tuttavia, puoi importare il progetto di sola lettura in un altro progetto Looker, dove potrai modificare i file. Inoltre, puoi utilizzare i file del repository clonato come punto di partenza, quindi utilizzare il parametro extends di Looker o i perfezionamenti per creare un progetto.

Nella pagina Nuovo progetto, specifica le seguenti opzioni per clonare un repository Git pubblico esistente in un progetto Looker:

  1. Project Name (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 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.
    • Nell'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.

  2. Punto di partenza: scegli Clona repository Git pubblico.

  3. 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 in modo da utilizzarlo nel formato corretto sostituendo "https://" con "git://" e aggiungendo ".git" alla fine. L'URL da inserire è git://github.com/llooker/blocks_redshift_admin.git.

Infine, fai clic su Crea progetto. Looker estrarrà tutti i file del repository pubblico in un nuovo progetto LookML e aprirà il progetto nell'IDE di Looker.

Creazione di un progetto vuoto

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

Nella pagina Nuovo progetto, specifica le seguenti opzioni per creare un progetto vuoto:

  1. Project Name (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 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.
    • Nell'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.

  2. Punto di partenza: scegli Progetto vuoto.

Infine, fai clic su Crea progetto. Looker crea il progetto e lo apre nell'IDE di Looker.

Passaggi successivi

Dopo aver creato un progetto, puoi: