Utilizzo del browser di file IDE

Puoi accedere all'IDE di Looker tramite il menu Sviluppa 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 visualizzate 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 progetto Looker non è organizzato in cartelle, avrà una struttura di file piatta, con i file elencati in ordine alfabetico nel riquadro File Browser. 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 Browser file. Puoi reimpostare la persistenza nelle Impostazioni IDE.

Puoi selezionare le icone nella barra degli strumenti nella parte superiore del riquadro File Browser 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 importati

Se importi un progetto, l'IDE di Looker crea automaticamente una cartella imported_projects. I file dei progetti locali e dei 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 apporti modifiche collettive ai 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 non ha eseguito il deployment delle modifiche, i suoi branch rifletteranno la struttura dei file esistente al momento dell'ultimo pull dalla 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 non ha eseguito il deployment delle modifiche durante la migrazione alle cartelle, si verificherà un conflitto di unione quando eseguirà il pull dalla produzione dopo la migrazione.
  • Applica un blocco temporaneo del codice a tutti gli sviluppatori finché non è stata completata la migrazione del progetto alla nuova struttura di directory.
  • Assegna a un singolo sviluppatore lo spostamento dei file. La procedura seguente presuppone che la migrazione del progetto alle cartelle dell'IDE venga eseguita da un singolo sviluppatore. Se devi far spostare i file da più sviluppatori, suddividi l'attività tra gli sviluppatori per evitare conflitti di unione. Se riscontri conflitti di unione, consulta la pagina della documentazione Utilizzo del controllo della versione e del deployment per informazioni su come risolverli.

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

Assegna a un singolo sviluppatore l'esecuzione di tutti i passaggi che seguono:

  1. Verifica che tutti gli aggiornamenti in tutti i branch di sviluppo siano stati implementati in produzione. 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 le eventuali istruzioni include e map_layer nel progetto in modo che corrispondano al nuovo percorso del file. Inoltre, potresti visualizzare errori di convalida di LookML per oggetti a cui viene fatto 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 estrarre gli aggiornamenti dalla produzione e riprendere lo sviluppo nel progetto.