El validador de contenido de integración continua (CI) identifica los paneles y los aspectos que tienen errores. A menudo, estos errores se deben a referencias faltantes 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 de forma manual cuando ejecutes un paquete de CI de forma manual.
- Puedes definir el alcance de los resultados del validador de contenido de CI para carpetas de contenido específicas de Looker o para modelos y exploraciones específicos en tu proyecto de LookML. De forma predeterminada, los resultados del validador de contenido de CI se aplican automáticamente a tu proyecto de LookML. El alcance del validador de contenido de CI es de procesamiento posterior: el validador se ejecuta en toda la instancia de Looker y, luego, filtra los resultados según el alcance que especificaste cuando creaste el paquete de CI.
El validador de contenido estándar de Looker admite lo siguiente:
- Solo puedes ejecutar el validador de contenido de Looker de forma manual.
- Puedes definir el alcance del Validador de contenido de Looker para carpetas de contenido de Looker específicas o para proyectos de LookML específicos. El alcance del validador de contenido de Looker se realiza antes de la validación: el validador se ejecuta solo 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 estilos.
Consulta la sección Opciones de Content Validator de esta página para obtener detalles sobre las opciones que puedes configurar cuando creas o editas un paquete de CI. Para obtener información sobre cómo ejecutar Content Validator, consulta la página de documentación Cómo ejecutar suites 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 aspecto o panel con errores, junto con un vínculo al contenido:
Opciones del validador de contenido
Puedes especificar varias opciones cuando creas un paquete 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:
- Explora para consultar
- Exploraciones para excluir
- Carpetas para validar
- Carpetas que se excluirán
- Cómo excluir contenido en espacios personales
- Validación incremental
Explora para consultar
De forma predeterminada, el validador de contenido ejecuta la validación de contenido en todos los modelos y exploraciones de tu proyecto de LookML.
Puedes usar el campo Exploraciones para consultar para especificar las exploraciones y los modelos que deseas incluir en la validación de contenido.
Puedes especificar Exploraciones en el siguiente formato: model_name/explore_name
Por ejemplo, para especificar las exploraciones denominadas users y orders en el archivo thelook.model.lkml, debes ingresar lo siguiente: thelook/users, thelook/orders
Consulta la página de documentación de 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 exploraciones de tu proyecto de LookML.
Puedes usar el campo Exploraciones para excluir para especificar las exploraciones y los modelos que deseas excluir de la validación de contenido.
Puedes especificar Exploraciones en el siguiente formato: model_name/explore_name
Consulta la página de documentación de Validador de SQL para obtener más información y ejemplos sobre cómo especificar exploraciones y modelos en este campo.
Carpetas para validar
Para definir el alcance de la validación de contenido en carpetas de contenido específicas de tu instancia de Looker, especifica 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 abrirla 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 que se excluirán
Para excluir carpetas de contenido específicas de la validación de contenido, especifica un ID de carpeta o una lista de IDs de carpetas separados por comas en el campo Carpetas para excluir.
Cómo excluir contenido en espacios personales
Si deseas que el Validador de contenido valide solo el contenido de las carpetas compartidas, habilita el campo Excluir contenido en espacios personales. Cuando el campo Excluir contenido en espacios 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 encontrar errores únicos de una rama de desarrollo específica, errores que aún 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 por los errores existentes en el proyecto y 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 elemento Explorar que se omitió porque no tenía cambios en su SQL compilado en la rama o 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.
Para habilitar la validación incremental del validador de contenido, selecciona la casilla de verificación Solo errores incrementales en la sección Validador de contenido cuando crees o edites un paquete 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, como en las 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 muestra estos errores de contenido "sueltos", ya que el modelo ya no se puede asociar con el proyecto que se está probando.