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 dei file (lettura all'apertura)
Quando apri un file .lkml nell'IDE locale, l'estensione recupera automaticamente la versione corrente del file dal ramo estratto nella modalità Development (Sviluppo) dell'istanza di Looker. In questo modo, lavori sempre sulla 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: sovrascrive 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 in locale 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 eseguite nell'IDE di Looker finché non le esegui nel repository remoto.
Quando utilizzi git push, la tua istanza di Looker estrae le modifiche di cui è stato eseguito il commit dal repository remoto. Dopo che l'istanza di Looker ha eseguito il pull dal repository remoto, le modifiche di cui hai 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 di cui non è ancora stato eseguito il commit e il push, verranno visualizzati come non sottoposti a commit.
Convalida LookML
L'estensione esegue automaticamente Looker LookML Validator 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 manualmente lo strumento di convalida LookML senza salvare i file utilizzando il comando Looker: Validate LookML (Looker: convalida LookML) della tavolozza dei comandi.