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 primero. Este modelo mantiene una relación trilateral 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 los 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 que se procesa en el Modo de desarrollo de tu instancia de Looker. Esto garantiza que siempre trabajes con la versión más actualizada del código.

Cómo guardar archivos (escritura al guardar)

Cuando guardas un archivo de forma local (Comando + S en Mac o Ctrl + S en Windows o Linux), la extensión envía de inmediato tus 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 los 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 del servidor de Looker por tu versión local de VS Code.

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

  • Keep Local: Sobrescribe la versión en el servidor de Looker con tu versión local de VS Code.
  • Pull Remote: Sobrescribe tu archivo local con la versión del servidor de Looker.

El parámetro de configuración looker.askBeforeOverwritingRemote está inhabilitado de forma predeterminada.

Operaciones locales de Git

La extensión sincroniza el contenido de los archivos, pero debes administrar tu repositorio de Git con los 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 coincidente.

Estado de Git en Looker

Cuando guardas los cambios en el archivo, 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. Una vez que tu instancia de Looker extraiga datos de forma remota, los cambios que hayas confirmado y enviado ya no aparecerán como no confirmados en el IDE de Looker. Solo aparecerán como no confirmados los archivos que se guardaron de forma local, pero que aún no se confirmaron ni enviaron.

Validar LookML

La extensión ejecuta automáticamente el Validador de LookML de Looker cada vez que guardas un cambio. Los errores de sintaxis y de modelo que devuelva el validador aparecerán intercalados en los 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?