Utilizzare il browser dei file dell'IDE

Puoi accedere all'IDE di Looker tramite il menu Sviluppo di Looker. Per dettagli e altre opzioni, consulta Accesso ai file di progetto.

L'IDE di Looker supporta le cartelle per i file di progetto. Le cartelle vengono mostrate nel riquadro di navigazione a sinistra dell'IDE.

IDE Looker con il browser di file che mostra le cartelle in un progetto di esempio.

Se il tuo progetto Looker non è organizzato in cartelle, avrà una struttura di file flat, con i file elencati in ordine alfabetico nel riquadro Browser file. Consulta Organizzare un progetto esistente con le cartelle IDE per informazioni su come aggiornare il progetto in modo che utilizzi le cartelle IDE.

L'IDE di Looker mantiene il file attualmente aperto e lo stato espanso o compresso del riquadro File Browser. Puoi reimpostare la persistenza nelle Impostazioni IDE.

Puoi selezionare le icone nella barra degli strumenti nella parte superiore del riquadro Browser file per comprimere tutte le cartelle, spostare ed eliminare file e cartelle, cercare un file di progetto o creare nuove cartelle e nuovi file.

Cartella dei progetti importata

Se importi un progetto, l'IDE di Looker crea automaticamente una cartella imported_projects. I file di progetti locali e di progetti remoti sono elencati nella cartella imported_projects. Seleziona un file di progetto importato dall'elenco dei file in imported_projects per visualizzarne i contenuti.

Poiché non possono essere modificati, i file di progetto importati non sono visibili quando modifichi collettivamente i file nell'IDE per spostarli o eliminarli.

Organizzazione di un progetto esistente con le cartelle IDE

Se il tuo progetto in precedenza aveva la struttura di file flat legacy o se vuoi riorganizzare i file in una cartella, puoi scegliere di mantenere questa struttura; ma se scegli di organizzare i file del tuo progetto in cartelle, ti consigliamo vivamente di fare quanto segue:

  • Pianifica in anticipo la struttura dei file con tutti gli sviluppatori.
  • Assicurati che tutti gli sviluppatori di Looker abbiano eseguito il deployment di tutti i loro aggiornamenti in produzione. Se uno sviluppatore ha annullato il deployment delle modifiche, i suoi rami rifletteranno la struttura dei file esistente all'ultimo estrazione dall'ambiente di produzione. Se all'epoca il progetto aveva una struttura di file flat, la versione dello sviluppatore del file verrà inviata in produzione nella sua posizione originale, per cui verranno create due copie del file. Inoltre, se uno sviluppatore ha annullato il deployment delle modifiche durante la migrazione alle cartelle, dovrà affrontare un conflitto di unione quando esegue il pull dall'ambiente di produzione dopo la migrazione.
  • Applica un blocco temporaneo del codice con tutti i tuoi sviluppatori finché non è stata completata la migrazione del progetto alla nuova struttura di directory.
  • Assegna un singolo sviluppatore per spostare i file. La procedura seguente presuppone che un singolo sviluppatore esegua la migrazione del progetto alle cartelle IDE. Se devi far spostare i file da più sviluppatori, dividi l'attività tra loro per evitare conflitti di unione. Se riscontri conflitti di unione, consulta la pagina della documentazione Utilizzo del controllo versione e del deployment per informazioni su come risolverli.

Dopo che tutti gli sviluppatori hanno eseguito il push e il commit delle modifiche e messo in pausa tutto il lavoro sul progetto, puoi eseguire la migrazione del progetto alla nuova struttura di directory.

Assegna un singolo sviluppatore per eseguire tutti i seguenti passaggi:

  1. Verifica che sia stato eseguito il deployment in produzione di tutti gli aggiornamenti in tutti i rami di sviluppo. Sono inclusi i rami di sviluppo dello sviluppatore che esegue la migrazione alle cartelle IDE.
  2. Verifica che tutti gli altri sviluppatori abbiano smesso di apportare modifiche al progetto.
  3. Esegui il pull dalla produzione.
  4. Crea le cartelle del progetto.
  5. Sposta i file del progetto nelle cartelle un file alla volta o utilizzando la modifica collettiva.
  6. Convalida il LookML del progetto. È normale che si verifichino più errori e avvisi LookML, poiché le istruzioni include e map_layer utilizzano riferimenti a posizioni di file che probabilmente verranno spostate durante questa procedura.
  7. Aggiorna eventuali istruzioni include e map_layer nel progetto in modo che corrispondano al nuovo percorso del file. Inoltre, potresti notare errori di convalida LookML per gli oggetti di riferimento che non possono più essere trovati perché i relativi percorsi file sono cambiati. Per ulteriori informazioni, consulta la documentazione sull'utilizzo di include con le cartelle IDE e sull'utilizzo di map_layer con le cartelle IDE.

  8. Esegui il commit delle modifiche.

  9. Esegui il deployment degli aggiornamenti in produzione.

  10. Comunica agli altri sviluppatori di Looker che ora possono recuperare gli aggiornamenti dall'ambiente di produzione e riprendere lo sviluppo nel progetto.