L'estensione Looker per VS Code utilizza un modello di sviluppo locale. Questo modello mantiene una relazione a tre vie tra il file system locale, la modalità di sviluppo dell'istanza Looker e il repository Git remoto.
Questa guida spiega come l'estensione sincronizza i file e in che modo le operazioni Git locali influiscono sul progetto Looker.
Meccanismo di sincronizzazione
L'estensione gestisce automaticamente la sincronizzazione dei contenuti dei file tra l'IDE locale e il server Looker.
Apertura di file (lettura all'apertura)
Quando apri un file .lkml nel tuo IDE locale, l'estensione recupera automaticamente la versione corrente del file dal ramo estratto nella modalità di sviluppo dell'istanza Looker. In questo modo avrai la certezza di lavorare sempre con la versione più aggiornata del codice.
Salvataggio dei file (scrittura al salvataggio)
Quando salvi un file localmente (Command-S su Mac o Ctrl+S su Windows/Linux), l'estensione esegue immediatamente il push delle modifiche locali sul server Looker. Queste modifiche sono quindi visibili nell'IDE Looker basato sul browser quando è attiva la modalità di sviluppo.
Gestire i conflitti di sincronizzazione
Se un file viene modificato nell'IDE di Looker basato su browser mentre è aperto anche in VS Code, potrebbe verificarsi un conflitto.
Per impostazione predefinita, l'estensione sovrascriverà la versione sul server Looker con la tua versione locale di VS Code.
Tuttavia, se hai attivato l'impostazione looker.askBeforeOverwritingRemote, VS Code mostra un avviso quando tenti di salvare un file modificato sul server. Puoi scegliere di effettuare una delle seguenti azioni:
- Mantieni locale: sovrascrive la versione sul server Looker con la versione locale di VS Code.
- Pull Remote: sovrascrivi il file locale con la versione del server Looker.
L'impostazione looker.askBeforeOverwritingRemote è disattivata per impostazione predefinita.
Operazioni Git locali
L'estensione sincronizza i contenuti dei file, ma devi gestire il repository Git utilizzando i comandi Git standard nel terminale locale o nella scheda Controllo origine dell'IDE locale.
Gestisci i branch
Quando cambi ramo localmente utilizzando git checkout, l'estensione rileva la modifica e cambia automaticamente la sessione sul server Looker con il ramo corrispondente.
Stato Git in Looker
Quando salvi le modifiche al file, queste vengono sincronizzate con l'istanza di Looker e vengono visualizzate come non commit nell'IDE Looker basato su browser. Se esegui il commit di queste modifiche utilizzando Git nel tuo ambiente locale, continueranno a essere visualizzate come non sottoposte a commit nell'IDE Looker finché non le esegui il push nel repository remoto.
Quando utilizzi git push, l'istanza Looker estrae le modifiche di cui è stato eseguito il commit dal repository remoto. Dopo che l'istanza di Looker ha eseguito il pull da remoto, le modifiche di cui è stato eseguito il commit e il push non verranno più visualizzate come non sottoposte a commit nell'IDE di Looker. Solo i file salvati localmente ma non ancora sottoposti a commit e push verranno visualizzati come non sottoposti a commit.
Convalida LookML
L'estensione esegue automaticamente il validatore LookML di Looker ogni volta che salvi una modifica. Gli errori di sintassi e del modello restituiti dallo strumento di convalida vengono visualizzati in linea all'interno dei file nell'IDE locale. Se vuoi, puoi anche eseguire lo strumento di convalida LookML manualmente senza salvare i file utilizzando il comando Looker: Validate LookML (Looker: convalida LookML) della tavolozza dei comandi.