Valida tu LookML

Cuando edites tu 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 de 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 una unión faltante, requieren una visión integral del 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. Si bien la validación no detectará todos los problemas, como los de permisos de la base de datos, evitará la mayoría de los errores.

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

  • Si cambia un parámetro de configuración a nivel del modelo, se vuelve a validar todo.
  • Si cambia una vista, solo se volverán a validar las exploraciones en las que se usa.
  • Si cambia una exploración, solo se vuelve a validar esa exploración.

Ejecutando 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 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, obtendrás 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”. Visite la página de prácticas recomendadas sobre el campo Error: 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 aún 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 la cantidad 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 Project Health y, luego, coloca el cursor sobre el ícono rojo de la 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.