Valida tu LookML

Cuando edites tu código LookML, el IDE de Looker te alertará sobre cualquier error de sintaxis sin resolver en un solo archivo (consulta la página de documentación Descripción general del IDE de Looker).

Para realizar una validación completa del modelo, usa el validador de LookML. Algunos errores, como una referencia de campo no válida debido a que falta una unión, requieren una mirada integral al modelo y, por lo tanto, solo se muestran cuando se ejecuta el validador de LookML. Asegúrate de validar los cambios de LookML antes de publicarlos en el entorno de producción. Aunque la validación no detectará todos los problemas, como los problemas de permisos de la base de datos, evitará la mayoría de los errores.

El validador de LookML solo analiza los archivos de LookML que se actualizaron desde la última validación de LookML o los archivos afectados por las actualizaciones:

  • Si cambia una configuración a nivel del modelo, todo se vuelve a validar.
  • Si cambia una vista, solo se vuelven a validar las Exploraciones en las que se usa.
  • Si una exploración cambia, solo esa exploración se vuelve a validar.

Ejecución de la validación

Para ejecutar el validador de LookML, selecciona el botón Validate LookML en la parte superior derecha del IDE de Looker. o selecciona el ícono Project Health en la parte superior del IDE para abrir el panel Project Health y, luego, haz clic en el ícono Validate LookML.

Después de ejecutar el validador de LookML, es posible que veas una lista de errores y otras advertencias que debes abordar. Puedes seleccionar cualquier flecha para expandir las listas de errores o advertencias.

El botón de validación del panel Estado del proyecto volverá a estar disponible si realizas y guardas otro cambio.

Mensajes de validación

Looker muestra mensajes de validación después de ejecutar la validación en tu LookML.

No se encontraron errores de LookML

Cuando el validador no detecta problemas, Looker muestra una marca de verificación verde junto con el texto No LookML errors found.

Errores de LookML

Los errores de LookML son problemas que podrían impedir que se ejecuten las consultas. El número entre paréntesis es la cantidad de errores encontrados (nueve en el siguiente ejemplo):

Ejemplo de un mensaje de validación con el texto Errores de LookML (9).

En la lista expandida de problemas, verás el motivo por el que no se aprobó la validación. A menudo, si haces clic en el error, te llevará directamente a la fila del código que presenta el problema. Verás una "X" roja. junto a la fila. Si colocas el cursor sobre él, podrás obtener información más detallada sobre el error en algunos casos:

Ejemplo de un error que aparece cuando se coloca el cursor sobre una definición de parámetro de tipo sin valor, con texto de error que indica que debes proporcionar un valor para el tipo.

Sugerencia para el equipo de Chat: El error de validación sobre el que más se nos preguntan es “Campo desconocido o inaccesible”. Visita la página de prácticas recomendadas Error: Campo desconocido o inaccesible para conocer las causas y qué hacer al respecto.

Advertencias de LookML

Es posible que las advertencias de LookML no impidan que se ejecute una consulta, pero aun así pueden generar una funcionalidad dañada o no deseada para tus usuarios. Al igual que con los errores, el número entre paréntesis es el número de advertencias encontradas (tres advertencias en el siguiente ejemplo):

Ejemplo de un mensaje de validación con el texto Advertencias de LookML (3).

Al igual que con los errores de LookML, puedes expandir las advertencias y saltar al código del problema. Para ello, selecciona la advertencia en el panel Estado del proyecto y, luego, coloca el cursor sobre el ícono rojo X para ver más información:

Ejemplo de una advertencia con texto que indica que la exploración debe coincidir con un nombre de vista o que debe tener una propiedad from o view_name.

Implementa cambios

Una vez que hayas validado que tus cambios funcionarán correctamente, puedes usar la integración Git de Looker para confirmar y, luego, implementar los cambios en la producción.