Accesso e modifica delle informazioni del progetto

La pagina Progetti LookML fornisce un elenco di tutti i progetti LookML nell'istanza di Looker e mostra tutti i modelli presenti in ogni progetto.

Per accedere alla pagina Progetti LookML, svolgi i seguenti passaggi:

1. Apri il riquadro Sviluppo selezionando l'opzione Sviluppo nel riquadro di navigazione.
2. Nel riquadro Sviluppo, seleziona Progetti.

Nota: questa pagina presuppone che tu abbia creato un progetto o che tu stia lavorando con un progetto esistente.

Visualizzazione dei progetti esistenti e dei relativi modelli

Per visualizzare un elenco dei progetti esistenti, vai alla pagina Progetti LookML.

In modalità di produzione, la pagina Progetti LookML elenca i progetti che sono stati generati e sottoposti a push in produzione. Nella modalità di sviluppo, nella pagina sono elencati i progetti di cui hai eseguito il pull dall'ambiente di produzione o che hai generato personalmente in modalità di sviluppo. La pagina Progetti LookML include le seguenti categorie di base:

• Sezione superiore: i progetti elencati nella sezione superiore sono stati creati e potrebbero includere file di modelli e visualizzazioni generati. Se sei un amministratore di Looker o se disponi dell'autorizzazione develop per almeno un modello in un progetto, puoi visualizzare il progetto nel riquadro Sviluppo e nella sezione superiore della pagina.
• Sezione Progetti in attesa: i progetti elencati nella sezione Progetti in attesa sono progetti in cui l'amministratore di Looker ha configurato le connessioni consentite per un modello, ma gli sviluppatori di Looker non hanno ancora generato il progetto e la definizione del modello. Se hai l'autorizzazione develop, puoi visualizzare questi progetti.
• Sezione Progetti Marketplace: i progetti elencati nella sezione Progetti Marketplace sono stati creati quando è stata installata un'applicazione, un blocco o un plug-in utilizzando il Looker Marketplace.

Nota: per visualizzare un progetto, devi disporre dell'autorizzazione manage_models o dell'autorizzazione develop per almeno un modello nel progetto. Se disponi dell'autorizzazione manage_models o dell'autorizzazione manage_project_models per almeno un modello nel progetto, puoi aggiungere o modificare la configurazione di qualsiasi modello associato a un progetto elencato.

Per informazioni su come specificare un nuovo progetto o un nuovo modello per un progetto esistente, consulta la pagina della documentazione Creazione di un nuovo progetto LookML.

Visualizzazione della scheda di un progetto

La pagina Progetti LookML mostra i seguenti elementi per ogni progetto:

• Colonna Progetto: il nome del progetto. Accanto a ogni progetto possono essere elencati uno o più modelli. Seleziona il nome del progetto per accedere al relativo codice LookML.
• Colonna Modelli: l'insieme di file di modelli LookML per il progetto specificato. Se l'ambiente della modalità di sviluppo è diverso da quello di produzione, questo elenco può cambiare da una modalità all'altra. Ad esempio, potresti aver creato in modalità di sviluppo un nuovo modello che non hai ancora inviato in produzione.
• Colonna Problemi di configurazione: se si verifica un problema con un modello, il modello mostra uno stato che indica il problema di configurazione.
• Pulsante Configura: se il pulsante Configura è disponibile per un progetto, puoi aggiungere o modificare la configurazione del modello per quel progetto.

Se si verifica un problema con un modello, viene visualizzato uno stato che indica il problema con la configurazione.

Problema	Spiegazione
Il file del modello LookML non esiste ancora	Questo problema si verifica se un utente ha configurato un modello in questa pagina, ma non ha ancora creato un file LookML corrispondente.
Configurazione richiesta per l'utilizzo	Questo problema si verifica se qualcuno ha creato un nuovo file di modello LookML in un progetto esistente, ma non lo ha ancora configurato in questa pagina.
Connessione "x" inesistente	L'attributo connection dichiarato nel file del modello non esiste (ad esempio se qualcuno ha commesso un errore ortografico o non lo ha ancora creato).
Modello "x" non può utilizzare la connessione "y"	Il valore connection dichiarato nel file del modello non è consentito in base alla configurazione in questa pagina.
Un modello denominato "x" è già configurato nel progetto "y"	I nomi dei modelli devono essere univoci all'interno dell'istanza di Looker, anche se si trovano in progetti diversi.

Visualizzazione dell'elenco per un progetto Marketplace

La sezione Progetti Marketplace della pagina Progetti LookML elenca i progetti creati durante l'installazione di un'applicazione, un blocco o un plug-in del marketplace. La scheda di ogni progetto del marketplace include i seguenti elementi:

• Scheda: un link alla scheda dell'applicazione, del blocco o del plug-in in Looker Marketplace.
• Project: il nome del progetto. Puoi fare clic sul nome del progetto per visualizzare o modificare il relativo LookML.
• Pulsante Visualizza LookML o Modifica LookML: puoi accedere a un progetto del marketplace selezionando il pulsante Visualizza LookML per il progetto principale di sola lettura di un blocco del marketplace o Modifica LookML per il progetto di configurazione, che può essere personalizzato. Per saperne di più sulla personalizzazione dei blocchi di Marketplace, consulta la pagina della documentazione Personalizzazione dei blocchi di Looker Marketplace.
• Modelli: l'insieme di file modello LookML per il progetto in questione.
• Pulsante Configura: se accanto all'elenco del progetto è disponibile il pulsante Configura, puoi aggiungere o modificare la configurazione del modello del progetto.

Visualizzazione dell'elenco di un progetto in attesa

La sezione Progetti in attesa contiene i modelli configurati con un nome di progetto, ma che non sono ancora stati generati. Pertanto, la sezione Progetti in attesa contiene progetti e modelli che sono configurati solo e che non dispongono ancora di alcun LookML.

Configurare i modelli prima dell'esistenza del progetto è utile se alcuni sviluppatori non hanno ricevuto l'autorizzazione manage_models o manage_project_models. Poiché il modello è già stato configurato, questi sviluppatori possono eseguire query non appena creano il progetto e il modello. Una volta generato il progetto, l'elenco di quel progetto viene spostato nella sezione superiore della pagina Progetti LookML.

La sezione Progetti in attesa include i seguenti elementi:

• Colonna Progetto: in questa sezione sono elencati i progetti configurati, ma non ancora generati. Il nome del progetto in questo campo è il nome previsto del progetto. Seleziona il nome del progetto per visualizzare la pagina Nuovo progetto in cui puoi generare il progetto. Per accedere alla pagina Nuovo progetto, devi essere in modalità di sviluppo.
• Colonna Modelli: il nome del modello specificato durante la creazione della configurazione del modello.
• Colonna Connessioni consentite: la colonna a destra del nome del modello mostra le connessioni consentite per questo modello al momento della creazione della configurazione del modello.
• Pulsante Configura: il pulsante Configurazione ti consente di modificare il nome del progetto e le connessioni consentite per questo modello.
• Pulsante Aggiungi LookML: il pulsante Aggiungi LookML apre la pagina Nuovo progetto per il progetto in questione, consentendoti di utilizzare il generatore LookML per generare automaticamente il codice LookML in base a un insieme di tabelle nel database.

Aggiunta e modifica di configurazioni

Se accanto all'elenco del progetto è disponibile il pulsante Configura, puoi aggiungere o modificare la configurazione del modello del progetto.

Se il modello non ha una configurazione, quando fai clic su Configura, Looker visualizza la finestra Configura un modello. Nella finestra Configura un modello, puoi specificare il nome del modello, il nome del progetto e le connessioni disponibili per il modello.

L'elenco delle connessioni include solo quelle che possono essere utilizzate con il progetto del modello. Le connessioni configurate per l'utilizzo in tutti i progetti sono contrassegnate dall'etichetta (Instance wide).

Se il modello ha una configurazione, quando fai clic su Configura, Looker visualizza la finestra Modifica configurazione modello. Nella finestra Modifica configurazione modello, puoi modificare le connessioni disponibili per il modello.

Quando modifichi la configurazione di un modello, puoi visualizzarne il nome, ma non rinominarlo. I modelli vengono denominati in base ai nomi file che utilizzi quando modifichi i file del modello nell'IDE di Looker.

Nel campo Progetto puoi specificare che il modello deve essere associato a un progetto diverso. Ad esempio, se hai creato un nuovo progetto che include un modello con lo stesso nome, puoi eseguire la transizione della configurazione del modello in modo che venga associata al modello del nuovo progetto.

Nel campo Connessioni consentite, puoi limitare il modello a utilizzare un elenco di connessioni specifiche oppure puoi consentire al modello di utilizzare qualsiasi connessione (tutte le connessioni attuali e future).

Ridenominare un progetto

Quando un amministratore di Looker crea un progetto LookML, fornisce un nome per il progetto. Il nome del progetto deve essere considerato un ID permanente per il progetto, poiché Looker lo utilizza nei seguenti modi:

• Per identificare il progetto per le chiamate API che hanno project_id come parametro.
• 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.
• Come parte dell'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.

Se disponi dell'autorizzazione Looker manage_models, puoi modificare il nome di un progetto LookML nella pagina Configurazione progetto del progetto. Gli sviluppatori di Looker che non sono amministratori possono visualizzare la pagina Configurazione progetto, ma non possono modificare le opzioni sulla pagina.

Avviso: se rinomini un progetto LookML, devi eseguire i seguenti passaggi:

• Aggiorna il parametro local_dependency nel file manifest di LookML di tutti i progetti LookML che utilizzano l'importazione del progetto locale per importare il progetto rinominato.
• Aggiorna le app web con chiamate API che utilizzano il parametro project_id per fare riferimento al progetto.
• Aggiorna il parametro project_name nel file manifest LookML del progetto LookML rinominato, se quest'ultimo ha un file manifest.
• Aggiorna i preferiti del browser o gli URL salvati, se tu o uno dei tuoi sviluppatori di LookML fate affidamento sugli URL per accedere ai file LookML del progetto rinominato.

Per rinominare un progetto:

1. Verifica di avere attivato la modalità di sviluppo.
2. Vai al tuo progetto nell'IDE di Looker.
3. Nel progetto, fai clic su Impostazioni nella barra di navigazione dell'IDE per aprire il riquadro delle impostazioni del progetto.
4. Seleziona Configurazione nel riquadro delle impostazioni del progetto.
5. Utilizza il campo Nome sotto Configurazione progetto per modificare il nome del progetto.
6. Nella pagina Configurazione progetto, fai clic su Salva configurazione progetto per salvare il nuovo nome del progetto.

Eliminazione di un progetto

Se sei un amministratore di Looker, puoi eliminare un progetto esistente dalle impostazioni del progetto. Per visualizzare le impostazioni del progetto, aprilo e fai clic su Impostazioni nella barra di navigazione dell'IDE.

Importante: la selezione del pulsante Elimina progetto rimuove tutto il codice LookML dal progetto, in tutti gli ambienti di sviluppo e di produzione dell'istanza di Looker. Prima di selezionare questo pulsante, assicurati di voler eliminare un progetto. Una volta eliminato un progetto, l'operazione di eliminazione non può essere annullata ed è difficile e laborioso recuperare un progetto eliminato.

Un progetto eliminato non viene più visualizzato nella sezione Progetti della pagina Progetti LookML, ma viene comunque visualizzato nella sezione Progetti configurati.

Per rimuovere la configurazione del progetto, che rimuove completamente il progetto dall'ambiente di sviluppo:

1. Vai al tuo progetto nell'IDE di Looker.
2. Nel progetto, fai clic su Impostazioni nella barra di navigazione dell'IDE per aprire il riquadro delle impostazioni del progetto.
3. Nel riquadro delle impostazioni progetto, scegli Configurazione per visualizzare la configurazione del progetto.
4. In Configurazione progetto, seleziona Elimina progetto.
5. Nella finestra Elimina progetto, verifica gli avvisi e le modifiche non sincronizzate che andranno perse se il progetto viene eliminato.
6. Se hai la certezza che il progetto debba essere eliminato, digita il nome del progetto nel campo. Per annullare l'operazione e tornare al progetto, utilizza il pulsante Indietro del browser.
7. Fai clic sul pulsante Elimina definitivamente <nome progetto>.