Utilizzo del browser di file IDE

Il modo più semplice per 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. Se gli sviluppatori di Looker non hanno organizzato i file del progetto in cartelle, il progetto avrà una struttura di file flat, con i file elencati in ordine alfabetico nel riquadro Browser file.

Ecco un esempio di progetto in cui uno sviluppatore ha aggiunto cartelle per diversi tipi di file di progetto, come esplorazioni, modelli e viste:

Progetto di esempio con una cartella Modelli che contiene un file del modello e una cartella Visualizzazioni contenente i file delle viste del progetto.

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.

Compressione della barra laterale dell'IDE

Puoi mostrare o nascondere il browser di file IDE utilizzando la scorciatoia da tastiera Comando-B (Mac) o Ctrl+B (Windows) oppure selezionando l'icona del browser di file:

Seleziona Browser file nella barra laterale dell'IDE per comprimere o espandere il browser di file.

Gestione di file e cartelle

Ogni file o cartella nel riquadro laterale a sinistra include un menu che mostra le azioni disponibili per quell'elemento. Seleziona il menu con tre puntini Azioni cartella (per le cartelle) o il menu Azioni file (per i file) a destra del nome file per aprire il menu. Per un elemento che ha un nome lungo o che è nidificato in più cartelle, puoi accedere al menu scorrendo nel riquadro a sinistra.

Puoi creare cartelle e file, caricare file ed eliminare e spostare file e cartelle utilizzando il browser di file. Per saperne di più, consulta la pagina della documentazione sulla gestione di file e cartelle LookML.

Quando organizzi i file LookML con le cartelle, devi eseguire il commit delle modifiche ed eseguirne il deployment in produzione prima che altri sviluppatori di Looker possano vederle. È come qualsiasi modifica che apporti al tuo progetto LookML.

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 di file in imported_projects per visualizzare i contenuti di quel file.

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 aveva in precedenza la struttura di file flat legacy o se vuoi riorganizzare i file in una cartella, puoi scegliere di mantenere questa struttura; tuttavia, se scegli di organizzare i file di progetto in cartelle, ti consigliamo vivamente di eseguire le seguenti preparazioni:

  • Pianifica in anticipo la struttura dei file con tutti gli sviluppatori.
  • Assicurati che tutti gli sviluppatori di Looker abbiano eseguito il deployment di tutti gli 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 della 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.