El Validador de contenido de integración continua (CI) identifica los paneles y las vistas que tienen errores. A menudo, estos errores se deben a referencias faltantes 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 un conjunto de CI de forma manual.
- Puedes limitar los resultados del Validador de contenido de CI a carpetas de contenido de Looker específicas o a modelos y exploraciones específicos en 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 alcance del Validador de contenido de CI es el 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 conjunto 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 limitar el Validador de contenido de Looker 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, para quitar campos y para borrar vistas.
Consulta la sección Opciones del Validador de contenido de esta página para obtener detalles sobre las opciones que puedes configurar cuando creas o editas un conjunto de CI. Para obtener información sobre cómo ejecutar el Validador de contenido, consulta la página de documentación Ejecuta conjuntos 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 vista o panel con errores, junto con un vínculo al contenido:
Opciones del Validador de contenido
Puedes especificar varias opciones cuando creas un conjunto 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
- 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 exploración 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 llamadas 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 exploración 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 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 limitar la validación de contenido a carpetas de contenido específicas en tu instancia de Looker si especificas un ID de carpeta o una lista de IDs de carpetas separada 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 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 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 si especificas un ID de carpeta o una lista de IDs de carpetas separada por comas en el campo Carpetas para excluir.
Excluir contenido en carpetas personales
Si deseas que el Validador de contenido valide solo el contenido de las carpetas compartidas, habilita el campo Excluir contenido en carpetas personales. Cuando el campo Excluir contenido en carpetas personales está habilitado, el Validador de contenido ignora 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, 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 exploración que se omitió porque no tenía cambios en su SQL compilado en la rama o la confirmación que se estaba validando. Consulta Visualiza 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 para el Validador de contenido, selecciona la casilla de verificación Solo errores incrementales en la sección Validador de contenido cuando crees o edites un conjunto 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 muestra estos errores de contenido "colgantes", ya que el modelo ya no se puede asociar con el proyecto que se está probando.