El Validador de contenido de integración continua (CI) identifica los paneles y los Looks que tienen errores. A menudo, estos errores se deben a que faltan referencias a campos de LookML.
El validador de contenido de CI realiza una validación similar a la del validador de contenido estándar de Looker, con algunas diferencias:
El validador de contenido de CI admite lo siguiente:
- Puedes configurar el validador de contenido de CI para que se ejecute automáticamente cuando un desarrollador de Looker envíe una solicitud de extracción a tu repositorio de LookML o manualmente cuando ejecutes manualmente un paquete de CI.
- Puedes acotar los resultados del Validador de contenido de CI a carpetas de contenido de Looker específicas o a modelos y Exploraciones concretos de tu proyecto de LookML. De forma predeterminada, los resultados del validador de contenido de CI se limitan automáticamente a tu proyecto de LookML. El ámbito del validador de contenido de CI es el posprocesamiento: el validador se ejecuta en toda la instancia de Looker y, a continuación, filtra los resultados según el ámbito que hayas especificado al crear el conjunto de pruebas de CI.
El validador de contenido estándar de Looker admite lo siguiente:
- Solo puedes ejecutar el validador de contenido de Looker manualmente.
- Puede limitar el alcance del validador de contenido de Looker a carpetas de contenido de Looker específicas o a proyectos de LookML concretos. El ámbito del Validador de contenido de Looker se define antes de la validación: el validador solo se ejecuta en las carpetas y los proyectos que hayas especificado al iniciar la validación de contenido.
- Puedes usar el validador de contenido de Looker para sustituir nombres de campos, vistas, Exploraciones y modelos, quitar campos y eliminar Looks.
Consulta la sección Opciones del validador de contenido de esta página para obtener información sobre las opciones que puedes configurar al crear o editar una suite de pruebas de integración continua. Para obtener información sobre cómo ejecutar Content Validator, consulta la página de documentación Ejecutar paquetes de integración continua.
En la página de resultados de la ejecución, el validador de contenido proporciona el mensaje de error de cada Look o panel que haya dado error, junto con un enlace al contenido:
Opciones de Validador de contenido
Puedes especificar varias opciones al crear una suite de integración continua para configurar cómo se ejecuta Content Validator. Las opciones se describen en las siguientes secciones de esta página:
- Exploraciones que consultar
- Exploraciones que excluir
- Carpetas que validar
- Carpetas que excluir
- Excluir contenido de carpetas personales
- Validación incremental
Exploraciones para consultar
De forma predeterminada, el Validador de contenido valida el contenido de todos los modelos y Exploraciones de tu proyecto de LookML.
Puede usar el campo Exploraciones para consultar para especificar la Exploración y los modelos que quiera incluir en la validación de contenido.
Puede especificar Exploraciones con el siguiente formato: model_name/explore_name
Por ejemplo, para especificar los Exploraciones llamados users y orders en el archivo thelook.model.lkml, introducirías lo siguiente: thelook/users, thelook/orders
Consulta la página de documentación Validador de SQL para obtener más información y ejemplos sobre cómo especificar Exploraciones y modelos en este campo.
Exploraciones que excluir
De forma predeterminada, el Validador de contenido validará el contenido de todos los modelos y Exploraciones de tu proyecto de LookML.
Puede usar el campo Exploraciones que excluir para especificar las exploraciones y los modelos que quiere excluir de la validación de contenido.
Puede especificar Exploraciones con el siguiente formato: model_name/explore_name
Consulta la página de documentación Validador de SQL para obtener más información y ejemplos sobre cómo especificar Exploraciones y modelos en este campo.
Carpetas que validar
Puede limitar la validación de contenido a carpetas de contenido específicas de su instancia de Looker. Para ello, especifique un ID de carpeta o una lista de IDs de carpetas separados por comas.
Para obtener el ID de una carpeta, usa el menú de navegación principal de Looker para abrir la carpeta y, a continuación, obtén el ID de la carpeta de la URL del navegador. El ID de la carpeta es el último elemento de la URL. Por ejemplo, en la siguiente URL, el ID de carpeta es 45:
https://myinstance.looker.com/folders/45
Carpetas que excluir
Puede excluir carpetas de contenido específicas de la validación de contenido. Para ello, especifique un ID de carpeta o una lista de IDs de carpeta separados por comas en el campo Carpetas que se van a excluir.
Excluir contenido de carpetas personales
Si quieres que el Validador de contenido valide solo el contenido de las carpetas compartidas, habilita el campo Excluir contenido de carpetas personales. Si el campo Excluir contenido de carpetas personales está habilitado, el Validador de contenido ignorará el contenido de las carpetas personales de tu instancia de Looker.
Validación incremental
La validación incremental es un método para detectar errores que son exclusivos de una rama de desarrollo específica (es decir, errores que no existen en producción). La validación incremental ayuda a los desarrolladores a encontrar y corregir los errores de los que son responsables sin distraerse con los errores que ya hay en el proyecto. Además, puede acelerar la validación, sobre todo en los proyectos de LookML que contienen muchas exploraciones.
En los resultados del validador, el validador de contenido indica cada Exploración que se ha omitido porque no se ha modificado su SQL compilado en la rama o la confirmación que se estaba validando. Consulta un ejemplo de resultados de validación incremental en Ver los resultados de la validación incremental.
Para habilitar la validación incremental en el validador de contenido, selecciona la casilla Solo errores incrementales en la sección Validador de contenido al crear o editar una suite de integración continua.
Ten en cuenta lo siguiente para la validación incremental:
- La configuración de validación incremental no se aplica cuando el validador de contenido valida la rama de producción (por ejemplo, en las ejecuciones manuales de la rama de producción). Al validar la rama de producción, el validador de contenido muestra los resultados de la validación completa.
Limitaciones de la validación de contenido
Si elimina un modelo o cambia su nombre, el Validador de contenido no devuelve estos errores de contenido "colgantes", ya que el modelo ya no se puede asociar al proyecto que se está probando.