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 archivos y cómo las operaciones de Git locales 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 extraída 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 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 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:
- Keep Local: Reemplaza la versión en el servidor de Looker por tu versión local de VS Code.
- Pull Remote: Reemplaza tu archivo local por la versión del servidor de Looker.
La configuración looker.askBeforeOverwritingRemote está inhabilitada de forma predeterminada.
Operaciones de Git locales
La extensión sincroniza el contenido de los archivos, pero debes administrar tu repositorio de Git con comandos de Git estándar 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.
Estado de Git en Looker
Cuando guardas los cambios en los archivos, se sincronizan con tu instancia de Looker y aparecen como sin confirmar en el IDE de Looker basado en el navegador. Si confirmas estos cambios con Git en tu entorno local, seguirán apareciendo como sin confirmar 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 extrae datos de forma remota, los cambios que confirmaste y enviaste ya no aparecerán como sin confirmar 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 sin confirmar.
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?
- Desarrollo asistido por IA (codificación de ambiente) con Looker
- Descripción general de la referencia de LookML