Accesso e modifica delle informazioni di un 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, segui questi 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.

visualizza i progetti esistenti e i 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 né 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 è stato installato un'applicazione, un blocco o un plug-in utilizzando 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 di manage_project_models per almeno un modello nel progetto, puoi aggiungere o modificare la configurazione per qualsiasi modello associato a un progetto in elenco.

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 dell'elenco 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 LookML del progetto.
• Colonna Modelli: l'insieme di file del modello LookML per il progetto in questione. Se il tuo ambiente Modalità sviluppo è diverso dalla modalità di produzione, questo elenco può passare dalla Modalità di sviluppo a quella di produzione e viceversa. 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 il progetto.

In caso di problemi con un modello, il modello mostra uno stato che indica il problema di configurazione.

Problema	Spiegazione
Il file del modello LookML non esiste ancora	Questo problema si verifica se qualcuno 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 del modello LookML in un progetto esistente, ma non lo ha ancora configurato in questa pagina.
La connessione "x" non esiste	L'elemento connection dichiarato nel file del modello non esiste (ad esempio se qualcuno l'ha digitato in modo errato o non l'ha ancora creato).
Il modello "x" non può utilizzare la connessione "y"	L'elemento connection dichiarato nel file del modello non è consentito in base alla configurazione mostrata 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, di un blocco o di un plug-in del Marketplace. L'elenco di ogni progetto Marketplace include i seguenti elementi:

• Elenco: un link all'elenco dell'applicazione, del blocco o del plug-in in Looker Marketplace.
• Progetto: 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 Marketplace selezionando il pulsante Visualizza LookML per un progetto principale di sola lettura di un blocco del Marketplace o Modifica LookML per il relativo progetto di configurazione, quest'ultimo dei quali 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 del 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 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 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: questa sezione elenca 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 relativa configurazione.
• Pulsante Configura: il pulsante Configurazione 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 del progetto, consentendoti di utilizzare il generatore LookML per generare automaticamente il LookML basato su un insieme di tabelle nel tuo 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 hanno l'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 visualizzare il nome del modello, 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 trasferire la 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).

Ridenominazione di 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.
• 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.
• Come parte dell'URL dei file di progetto. Ad esempio, su un'istanza di Looker con l'URL example.looker.com, il file manifest del progetto denominato ecommerce è disponibile a questo 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 utilizzando la pagina Impostazioni progetto del progetto. Gli sviluppatori di Looker che non sono amministratori possono visualizzare la pagina Impostazioni progetto, ma non possono modificare le opzioni nella pagina.

Avviso: se rinomini un progetto LookML, dovrai effettuare le seguenti operazioni:

• Aggiorna il parametro local_dependency nel file manifest LookML di qualsiasi progetto LookML che utilizza l'importazione di progetti locali per importare il progetto rinominato.
• Aggiorna tutte 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 il progetto ha un file manifest.
• Aggiorna i preferiti del browser o gli URL salvati, se tu o uno dei tuoi sviluppatori LookML utilizzate gli 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 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 utilizzando la pagina Impostazioni progetto del progetto. Per vedere la pagina Impostazioni progetto, apri il progetto e fai clic su Impostazioni nella barra di navigazione dell'IDE.

Importante: se selezioni il pulsante Elimina progetto, tutti i LookML vengono rimossi dal progetto in tutti gli ambienti di sviluppo e produzione nell'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 ancora visualizzato nella sezione Progetti configurati.

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

1. Vai al tuo progetto nell'IDE di Looker.
2. Nel tuo progetto, fai clic su Impostazioni nella barra di navigazione dell'IDE per aprire il riquadro Impostazioni 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, digitane il nome 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>.