Utilizzare il browser di file IDE

Il modo più semplice per accedere all'IDE di Looker è tramite il menu Sviluppo di Looker. Vedi Accesso ai file di progetto per dettagli e altre opzioni.

L'IDE di Looker supporta le cartelle per i file di progetto. Le cartelle sono visualizzate nel riquadro di navigazione a sinistra dell'IDE. Se gli sviluppatori di Looker non hanno organizzato i file di progetto in cartelle, il progetto avrà una struttura a file flat, con i file elencati in ordine alfabetico nel riquadro Browser file.

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

Progetto di esempio con una cartella Modelli contenente 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 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 di 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 a sinistra ha un menu in cui vengono visualizzate le azioni disponibili per l'elemento in questione. 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 accedere al menu di un elemento con un nome lungo o nidificato in più cartelle, puoi scorrere il 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 in cartelle, devi eseguire il commit delle modifiche ed eseguirne il deployment in produzione prima che altri sviluppatori di Looker possano vederle. Si tratta di una qualsiasi modifica che apporti al tuo progetto LookML.

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 spostare o eliminare questi file.

Organizzazione di un progetto esistente con le cartelle IDE

Se in precedenza il tuo progetto aveva la precedente struttura di file flat o se desideri riorganizzare i file in una cartella, puoi scegliere di mantenere questa struttura; se invece scegli di organizzare i file di progetto in cartelle, ti consigliamo vivamente di effettuare le seguenti operazioni:

  • 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 modifiche di cui non è stato eseguito il deployment, i suoi rami rifletteranno la struttura dei file esistente al momento dell'ultimo estrazione dalla produzione. Se al momento il progetto aveva una struttura di tipo flat file, la versione dello sviluppatore del file verrà messa in produzione nella posizione originale, quindi ti ritroverai con due copie del file. Inoltre, se uno sviluppatore ha annullato il deployment di modifiche durante la migrazione alle cartelle, dovrà affrontare un conflitto di unione quando esegue il pull dall'ambiente di produzione dopo la migrazione.
  • Applicare un blocco temporaneo del codice a tutti gli sviluppatori fino a quando il progetto non è stato completamente migrato nella nuova struttura di directory.
  • Assegna a un singolo sviluppatore lo spostamento dei file. La procedura riportata di seguito presuppone che un singolo sviluppatore eseguirà la migrazione del progetto alle cartelle IDE. Se devi far spostare i file da più sviluppatori, dividi l'attività tra gli sviluppatori per evitare conflitti di unione. In caso di conflitti di unione, consulta la pagina della documentazione relativa all'utilizzo del controllo delle versioni e del deployment per informazioni sulla loro risoluzione.

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

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

  1. Verifica che tutti gli aggiornamenti su tutti i rami 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 di progetto nelle cartelle, un file alla volta o utilizzando la modifica collettiva.
  6. Convalida il LookML del progetto. Sono previsti più errori e avvisi di LookML, poiché le istruzioni include e map_layer utilizzano riferimenti a posizioni dei file che probabilmente verranno spostate durante questa procedura.
  7. Aggiorna le istruzioni include e map_layer del progetto in modo che corrispondano al nuovo percorso del file. Inoltre, potresti visualizzare errori di convalida di LookML per gli oggetti a cui viene fatto riferimento che non possono più essere trovati a causa della modifica dei percorsi dei file. Per saperne di più, 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 Looker che ora possono recuperare gli aggiornamenti dalla produzione e riprendere lo sviluppo nel progetto.