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 la falta de referencias a los 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 de forma manual cuando ejecutes manualmente un conjunto de pruebas de CI.
- Puedes definir el alcance de los resultados del Validador de contenido de CI para que se apliquen a carpetas de contenido de Looker específicas o a modelos y exploraciones específicos de tu proyecto de LookML. De forma predeterminada, los resultados del CI Content Validator se limitan automáticamente a tu proyecto de LookML. El alcance del validador de contenido de CI es posterior al procesamiento: el validador se ejecuta en toda la instancia de Looker y, luego, filtra los resultados según el alcance que especificaste cuando creaste el conjunto de CI.
El validador de contenido estándar de Looker admite lo siguiente:
- Solo puedes ejecutar el Validador de contenido de Looker manualmente.
- Puedes definir el alcance del Validador de contenido de Looker para que se aplique a carpetas de contenido de Looker específicas o a proyectos de LookML específicos. El alcance del validador de contenido de Looker se produce antes de la validación: el validador solo se ejecuta en las carpetas y los proyectos que especificaste cuando iniciaste la validación de contenido.
- Puedes usar el Validador de contenido de Looker para reemplazar nombres de campos, vistas, Exploraciones y modelos, quitar campos y borrar Looks.
Consulta la sección Opciones del Validador de contenido en esta página para obtener detalles sobre las opciones que puedes configurar cuando creas o editas un conjunto de pruebas de CI. Para obtener información sobre cómo ejecutar el Validador de contenido, consulta la página de documentación Cómo ejecutar conjuntos de pruebas de integración continua.
En la página de resultados de la ejecución, el Validador de contenido proporciona el mensaje de error para cada Look o panel con errores, junto con un vínculo al contenido:
Opciones del Validador de contenido
Puedes especificar varias opciones cuando crees un conjunto de pruebas de integración continua para configurar cómo se ejecuta el Validador de contenido. Las opciones se describen en las siguientes secciones de esta página:
- Exploraciones para consultar
- Exploraciones para excluir
- Carpetas para validar
- Carpetas para excluir
- Cómo excluir contenido en carpetas personales
- Validación incremental
Exploraciones para consultar
De forma predeterminada, el Validador de contenido ejecuta la validación de contenido en todos los modelos y las Exploraciones de tu proyecto de LookML.
Puedes usar el campo Exploraciones para consultar para especificar la función Explorar y los modelos que deseas incluir en la validación de contenido.
Puedes especificar Explorar en el siguiente formato: model_name/explore_name
Por ejemplo, para especificar los Explorar llamados users y orders en el archivo thelook.model.lkml, ingresarías lo siguiente: thelook/users, thelook/orders
Consulta la página de documentación del Validador de SQL para obtener más información y ejemplos sobre cómo especificar Exploraciones y modelos en este campo.
Exploraciones para excluir
De forma predeterminada, el Validador de contenido ejecutará la validación de contenido en todos los modelos y las Exploraciones de tu proyecto de LookML.
Puedes usar el campo Exploraciones para excluir para especificar la función Explorar y los modelos que deseas excluir de la validación de contenido.
Puedes especificar Explorar en el siguiente formato: model_name/explore_name
Consulta la página de documentación del Validador de SQL para obtener más información y ejemplos sobre cómo especificar Exploraciones y modelos en este campo.
Carpetas para validar
Puedes definir el alcance de la validación de contenido para que se aplique a carpetas de contenido específicas en tu instancia de Looker. Para ello, especifica un ID de carpeta o una lista de IDs de carpeta separados por comas.
Para obtener el ID de una carpeta, usa el menú de navegación principal de Looker para abrir la carpeta y, luego, obtén el ID de la carpeta desde 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 la carpeta es 45:
https://myinstance.looker.com/folders/45
Carpetas para excluir
Puedes excluir carpetas de contenido específicas de la validación de contenido. Para ello, especifica un ID de carpeta o una lista de IDs de carpeta separados por comas en el campo Carpetas para excluir.
Cómo excluir contenido en carpetas personales
Si deseas que el Validador de contenido valide solo el contenido de las carpetas compartidas, habilita el campo Excluir el contenido de las carpetas personales. Cuando el campo Exclude content in personal folders 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 encontrar errores que son únicos en una rama de desarrollo específica, errores que aún no existen en la 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 existentes en el proyecto. También puede acelerar la validación, en especial para los proyectos de LookML que contienen muchas Exploraciones.
En los resultados del validador, el Validador de contenido indica cada Explore que se omitió porque no tenía cambios en su código SQL compilado en la rama o la confirmación que se estaba validando. Consulta Cómo ver los resultados de la validación incremental para ver un ejemplo de los resultados de la validación incremental.
Puedes habilitar la validación incremental para el Validador de contenido seleccionando la casilla de verificación Solo errores incrementales en la sección Validador de contenido cuando crees o edites un conjunto de pruebas de integración continua.
Ten en cuenta lo siguiente para la validación incremental:
- El parámetro de configuración de validación incremental no se aplica cuando el Validador de contenido valida la rama de producción en sí, como con ejecuciones manuales en la rama de producción. Cuando se valida la rama de producción, el Validador de contenido muestra la validación de resultados completa.
Limitaciones de la validación de contenido
Si borras un modelo o cambias su nombre, el Validador de contenido no devuelve estos errores de contenido "pendientes", ya que el modelo ya no se puede asociar con el proyecto que se está probando.