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. Scopri di più sui progetti nelle pagine della documentazione sui progetti e il modello di sviluppo LookML e sui termini 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. Se vuoi concedere agli utenti l'accesso a un modello, ma non a un altro, ti consigliamo di creare un progetto separato contenente il modello a cui non desideri che abbiano accesso.
Gli utenti di Looker con l'autorizzazione manage_models
possono creare modelli LookML su un'istanza di Looker.
Creazione di un progetto
Per creare un progetto, svolgi i seguenti passaggi:
Seleziona Progetti dalla sezione Sviluppo del pannello di navigazione.
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 eseguiti dipendono dall'opzione Punto di partenza che scegli nella pagina Nuovo progetto. Le seguenti sezioni descrivono il funzionamento di questi punti di partenza:
- Generazione automatica di un modello a partire dal tuo database
- Clonazione di un repository Git pubblico
- Creare un progetto vuoto
Generazione automatica di un modello dal tuo database
Se come punto di partenza selezioni Genera modello da schema database, il generatore LookML crea automaticamente il modello e visualizza i file di progetto in base alle tabelle contenute nel database. Per ulteriori informazioni, consulta la pagina della documentazione Generazione di un modello.
Con questa opzione, Looker chiede il nome della connessione in modo da poter generare automaticamente il codice LookML in base al tuo database. Tuttavia, puoi sempre aggiungere ulteriori connessioni in un secondo momento.
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 dei tuoi progetti 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.
Per clonare un repository Git pubblico esistente in un progetto Looker:
- Verifica di essere in modalità di sviluppo.
- Seleziona Gestisci progetti LookML dal menu Sviluppo.
Nella pagina Progetti LookML, seleziona Nuovo progetto LookML per aprire la pagina Nuovo progetto.
Nella pagina Nuovo progetto, specifica le opzioni per il tuo progetto:
Project Name (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.
- Per 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.
- Nell'URL dei file di progetto. Ad esempio, su un'istanza di Looker con l'URL
example.looker.com
, il file manifest del progetto denominatoecommerce
è disponibile a questo URL:https://example.looker.com/projects/ecommerce/files/manifest.lkml
.
- Per identificare il progetto per le chiamate API che hanno il parametro
Punto di partenza: scegli Clona repository Git pubblico.
URL repository Git: inserisci l'URL del repository Git pubblico. Assicurati che l'URL sia nel formato
Se hai un URL comegit://github.com/example/my-repository.git
.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
.
Seleziona 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 in corso...
Se selezioni Progetto vuoto come punto di partenza, Looker crea un progetto vuoto in modo da poter creare i file LookML da zero.
Per creare un progetto vuoto:
- Verifica di essere in modalità di sviluppo.
- Seleziona Gestisci progetti LookML dal menu Sviluppo.
Nella pagina Progetti LookML, seleziona Nuovo progetto LookML per aprire la pagina Nuovo progetto.
Nella pagina Nuovo progetto, specifica le opzioni per il tuo progetto:
Project Name (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.
- 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.
- Nell'URL dei file di progetto. Ad esempio, su un'istanza di Looker con l'URL
example.looker.com
, il file manifest del progetto denominatoecommerce
è disponibile a questo URL:https://example.looker.com/projects/ecommerce/files/manifest.lkml
.
- Per identificare il progetto per le chiamate API che hanno il parametro
Punto di partenza: scegli Progetto vuoto.
Seleziona Crea progetto. Looker crea il progetto e lo apre nell'IDE di Looker.
Una volta creato un progetto vuoto, puoi creare file di modello e visualizzazione, quindi connettere il progetto a Git in modo da registrare le modifiche ai file LookML e gestire le versioni dei file.
Configurazione di un modello
Utilizza il pulsante Configura nuovo modello nella parte superiore della pagina Progetti LookML per aggiungere una configurazione per un modello esistente o pianificato.
La configurazione di un modello per un progetto che non esiste ancora è utile se agli sviluppatori non è stata concessa l'autorizzazione manage_models
o manage_project_models
, come descritto nella pagina della documentazione Generazione di un modello. Se configuri il modello per gli sviluppatori, questi potranno eseguire query non appena generano o creano il file del modello. Per saperne di più sui progetti che hanno solo una configurazione, consulta la pagina della documentazione Accesso e modifica delle informazioni sul progetto.
Puoi anche specificare quali connessioni al database possono essere utilizzate dal modello oppure puoi specificare che il modello può utilizzare qualsiasi connessione attuale o futura. Gli sviluppatori di Looker utilizzano il parametro LookML connection
per specificare nel file del modello quale connessione deve utilizzare il modello. Se uno sviluppatore specifica una connessione che non hai consentito nella configurazione del modello, nessuna query su quel modello verrà eseguita.