Administra archivos de LookML y Git con la extensión de Looker para VS Code

La extensión de Looker para VS Code usa un modelo de desarrollo local. Este modelo mantiene una relación de tres vías entre tu sistema de archivos local, el modo de desarrollo de tu instancia de Looker y tu repositorio de Git remoto.

En esta guía, se explica cómo la extensión sincroniza archivos y cómo las operaciones locales de Git afectan tu proyecto de Looker.

Mecanismo de sincronización

La extensión administra automáticamente la sincronización del contenido de los archivos entre tu IDE local y el servidor de Looker.

Apertura de archivos (lectura al abrir)

Cuando abres un archivo .lkml en tu IDE local, la extensión recupera automáticamente la versión actual de ese archivo de la rama confirmada en el modo de desarrollo de tu instancia de Looker. Esto garantiza que siempre trabajes en la versión más actualizada del código.

Guardado de archivos (escritura al guardar)

Cuando guardas un archivo de forma local (Command-S en Mac o Ctrl+S en Windows o Linux), la extensión envía de inmediato los cambios locales al servidor de Looker. Luego, estos cambios se pueden ver en el IDE de Looker basado en el navegador cuando estás en el modo de desarrollo.

Cómo controlar conflictos de sincronización

Si se edita un archivo en el IDE de Looker basado en el navegador mientras también está abierto en VS Code, es posible que se produzca un conflicto.

De forma predeterminada, la extensión reemplazará la versión en el servidor de Looker por tu versión local de VS Code.

Sin embargo, si habilitaste la configuración looker.askBeforeOverwritingRemote, VS Code muestra una advertencia cuando intentas guardar un archivo que se modificó en el servidor. Puedes elegir una de las siguientes acciones:

  • Ver diferencias: Abre un editor de diferencias para comparar los cambios entre las versiones remotas y locales del archivo. Esta opción te permite ver y combinar cambios de forma selectiva línea por línea para resolver el conflicto y volver a sincronizar los cambios locales combinados con el servidor de Looker.
  • Overwrite Remote: Reemplaza la versión en el servidor de Looker por tu versión local de VS Code.
  • Overwrite Local: Reemplaza tu archivo local por la versión del servidor de Looker.

La configuración looker.askBeforeOverwritingRemote está inhabilitada de forma predeterminada.

Operaciones locales de Git

La extensión sincroniza el contenido de los archivos, pero debes administrar tu repositorio de Git con comandos estándar de Git en tu terminal local o en la pestaña Control de código fuente del IDE local.

Administrar ramas

Cuando cambias de rama de forma local con git checkout, la extensión detecta el cambio y cambia automáticamente tu sesión en el servidor de Looker a la rama correspondiente.

Antes de que Looker sincronice los cambios en tus archivos, la extensión de Looker para VS Code verifica que tu rama de Git local coincida con tu rama del modo de desarrollo de Looker, y pausa automáticamente la sincronización si las ramas divergen, lo que evita que se reemplacen las ramas cruzadas. Si se produce una falta de coincidencia, una instrucción interactiva te permite cambiar tu lugar de trabajo remoto de Looker o confirmar la rama de forma local, lo que invalida automáticamente los hashes de archivos almacenados en caché cuando se alinea para reanudar la sincronización de forma segura.

Estado de Git en Looker

Cuando guardas los cambios en los archivos, se sincronizan con tu instancia de Looker y aparecen como no confirmados en el IDE de Looker basado en el navegador. Si confirmas estos cambios con Git en tu entorno local, seguirán apareciendo como no confirmados en el IDE de Looker hasta que los envíes a tu repositorio remoto.

Cuando usas git push, tu instancia de Looker extrae los cambios confirmados de tu repositorio remoto. Después de que tu instancia de Looker extraiga datos de forma remota, los cambios que confirmaste y enviaste ya no aparecerán como no confirmados en el IDE de Looker. Solo los archivos que se guardan de forma local, pero que aún no se confirmaron ni enviaron, aparecerán como no confirmados.

Validar LookML

La extensión ejecuta automáticamente el Validador de LookML de Looker cada vez que guardas un cambio. Cualquier error de sintaxis y modelo que devuelva el Validador aparecerá intercalado en tus archivos dentro de tu IDE local. Si lo deseas, también puedes ejecutar el Validador de LookML de forma manual sin guardar archivos con el comando Looker: Validate LookML de la paleta de comandos.

¿Qué sigue?