Validar el LookML

Cuando edites tu LookML, el IDE de Looker te avisará de los errores 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 una combinación que falta, 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. Aunque la validación no detectará todos los problemas (por ejemplo, los relacionados con los permisos de la base de datos), sí evitará la mayoría de los errores.

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

  • Si cambia un ajuste a nivel de modelo, se vuelve a validar todo.
  • Si una vista cambia, solo se vuelven a validar las exploraciones en las que se usa.
  • Si un Exploración cambia, solo se vuelve a validar ese Exploración.

Validación en curso

Para ejecutar el validador de LookML, selecciona el botón Validar LookML en la parte superior derecha del IDE de Looker o el icono Estado del proyecto en la parte superior del IDE para abrir el panel Estado del proyecto y, a continuación, haz clic en el icono Validar LookML.

Después de ejecutar el validador de LookML, puede que vea una lista de errores y otras advertencias que debe solucionar. Puedes seleccionar cualquier flecha para desplegar las listas de errores o advertencias.

El botón de validador del panel Estado del proyecto volverá a estar disponible si haces 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 han encontrado errores de LookML

Si el validador no encuentra ningún problema, Looker muestra una marca de verificación verde junto con el texto No se han encontrado errores de LookML.

Errores de LookML

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

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

En la lista ampliada de problemas, verá el motivo por el que no se ha superado la validación. A menudo, si haces clic en el error, se te dirigirá directamente a la fila de código que provoca el problema. Verás una "X" roja junto a la fila. En algunos casos, si colocas el cursor sobre él, se mostrará información más detallada sobre el error:

Ejemplo de un error que aparece al colocar el cursor sobre una definición de parámetro de tipo sin valor, con un texto de error que indica que debe proporcionar un valor para el tipo.

Consejo del equipo de chat: El error de validación que más se nos pregunta es "Campo desconocido o inaccesible". Visite la página de prácticas recomendadas Error: Unknown or inaccessible field (Error: campo desconocido o inaccesible) para saber cuáles son las causas y qué puede hacer al respecto.

Advertencias de LookML

Es posible que las advertencias de LookML no impidan que se ejecute una consulta, pero pueden provocar que los usuarios tengan problemas o que las funciones no funcionen como deberían. Al igual que con los errores, el número entre paréntesis indica el número de advertencias encontradas (tres advertencias en el siguiente ejemplo):

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

Al igual que con los errores de LookML, puedes desplegar las advertencias y saltar al código del problema seleccionando la advertencia en el panel Estado del proyecto y, a continuación, colocando el cursor sobre el icono 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.

Desplegar los cambios

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