El Validador de contenido busca en LookML el modelo, la exploración y los nombres de los campos a los que se hace referencia en tu contenido de Looker. Es una herramienta útil para validar tus referencias de LookML, corregir errores en LookML después de realizar cambios y actualizar los nombres de los elementos de LookML en tu proyecto.
Debes tener el permiso develop para usar el Validador de contenido.
Para abrir el Validador de contenido, selecciona Validador de contenido en el menú Desarrollar en el panel de navegación izquierdo. Desde aquí, puedes usar el Validador de contenido de dos maneras:
- Haz clic en Validar para encontrar y corregir errores causados por cambios en tu modelo de LookML.
- Haz clic en Buscar y reemplazar en todo el contenido para buscar y reemplazar el modelo, la función Explorar o los nombres de los campos en tu contenido de Looker, sin importar si hay o no errores en el contenido de Looker.
Antes de usar el Validador de contenido
Debes tener extremely cuidado cuando realices cambios con la validación de contenido. El Validador de contenido no tiene la función de deshacer y tiene el potencial de afectar a muchas Vistas y paneles, junto con los vínculos de Explorar desde aquí. Si cometes un error, debes intentar corregirlo lo antes posible, antes de que los cambios adicionales hagan que sea más difícil aislar las vistas afectadas.
Además, ten en cuenta el tiempo que tardarás cuando uses el Validador de contenido. Cuando envías cambios de desarrollo a producción, debes corregir las vistas y los mosaicos afectados aproximadamente al mismo tiempo, de modo que no funcionen correctamente durante el menor tiempo posible. Si corriges las Vistas y los mosaicos demasiado pronto en función de tu trabajo en Modo de desarrollo, los usuarios no los verán hasta que envíes los cambios. Del mismo modo, si demoras en corregir las vistas y los mosaicos hasta mucho después de implementar los cambios, los usuarios verán que estos no funcionan hasta que los corrijas.
Cómo usar el Validador de contenido para corregir errores
El Validador de contenido es una herramienta útil para encontrar y corregir errores resultantes de cambios en tu LookML. Por ejemplo, si cambias el nombre de un campo de customer a user, las Vistas o los mosaicos del panel que incluyeran el campo customer dejarán de funcionar (a menos que hayas usado el parámetro alias). El Validador de contenido enumerará todas las referencias al campo customer y proporcionará una manera fácil de corregir el error.
Cuando ejecutas el Validador de contenido, se validan todas las referencias que tus Vistas y paneles hagan a tus modelos, Exploraciones, vistas y campos de LookML, y mostrará un error por cualquier referencia que tu contenido haga a un objeto de LookML desconocido.
El Validador de contenido no muestra errores para los siguientes elementos:
- Contenido para el que no tienes el permiso
develop. El Validador de contenido se limita a tus permisos, por lo que solo puedes usarlo en el contenido para el que tienes el permisodevelop(los modelos que puedes ver en el IDE de Looker). Consulta la página de documentación de Funciones para obtener información sobre los permisos de modelo. - Las vistas que se borraron y están en la Papelera. Si quieres validar una vista borrada, primero el administrador de Looker debe restablecerla.
Ejecución del Validador de contenido
Sigue estos pasos para validar tu LookML con el Validador de contenido:
- Haz clic en Validate.
- Selecciona las pestañas Agrupar por para cambiar cómo se agrupan los errores:
- Error: Enumera cada error y agrupa el contenido de Looker que tiene el error. Esto es útil si deseas corregir el mismo error en varios elementos de contenido a la vez.
- Carpeta: Muestra cada carpeta y agrupa el contenido de Looker que tiene errores. Esto es útil si quieres corregir solo los errores de una carpeta en particular.
- Contenido: Enumera cada contenido que tenga errores y agrupa los errores. Esto es útil si quieres corregir todos los errores en una sola vista, mosaico, filtro, etcétera.
- Si estás en Modo de desarrollo, Looker mostrará un mensaje de advertencia. Es importante comprender las implicaciones de cambiar las Vistas y las tarjetas. Si los corriges antes de publicar los cambios rotundos, habrá un período en el que la corrección será prematura, por lo que los usuarios experimentarán vistas o mosaicos dañados. El mensaje de advertencia te ayuda a recordar esto.
- En la tabla de errores, se muestra cualquier error, junto con una lista de vistas y mosaicos que contienen el error, además del modelo subyacente y la función Explorar que producen el error. Puedes usar las pestañas Agrupar por en la parte superior derecha de la página para cambiar el diseño de la tabla de errores.
- Looker proporciona los botones Reemplazar o Quitar para cada fila, según el tipo de error. Estos botones permiten corregir los errores y se describen con más detalle en Cómo usar el Validador de contenido para corregir errores.
Visualiza los resultados de la validación de contenido
Los resultados de la validación de contenido muestran contenido de Looker que usa nombres de modelos, nombres de Explorar, nombres de vistas o nombres de campos que no existen o no se pueden encontrar. Consulta la sección Usa el Validador de contenido para corregir errores si quieres obtener detalles sobre los elementos de LookML que el Validador de contenido puede encontrar y validar.
El ícono junto al nombre del contenido identifica el tipo de contenido:
: Tarjeta del panel
: Alerta del panel
: Programa para un panel o una vista
: Filtra por un panel o un campo en un mosaico que escucha un filtro de panel (consulta la página de documentación Agrega y edita filtros de panel definidos por el usuario si deseas obtener información sobre la configuración de mosaicos para escuchar los filtros del panel).
Los resultados de la validación se basan en el LookML que está disponible en el modo en el que te encuentras cuando ejecutas el validador. Si estás en modo de producción, los resultados de la validación reflejarán todo LookML que se envió a producción. Si estás en Modo de desarrollo, los resultados de la validación reflejarán tu LookML guardado, incluso si no se envió a producción.
Los errores pueden deberse a cambios intencionales en LookML, así como a un error tipográfico o a una unión faltante.
Para ajustar los errores, puedes usar los botones Replace y Remove en cada línea de la tabla de errores de la siguiente manera:
- Reemplazar: Looker proporciona el botón Reemplazar para cada error (consulta la sección Reemplazar nombres por campos, vistas, Exploraciones y modelos más adelante en esta página para descubrir cómo reemplazar nombres con el Validador de contenido).
- Quitar: Para los errores con nombres de campo en la sección Datos de una vista o un mosaico, Looker también muestra el botón Quitar (consulta la sección Quita el nombre de un campo más adelante en esta página para saber cómo quitar nombres con el Validador de contenido).
Según el parámetro de configuración que elijas en Agrupar por, los botones se aplicarán a un solo elemento (vista o mosaico) o a varios elementos:
- Si agrupas por Error, los botones se aplican a todos los casos de ese error en todas las vistas y mosaicos de tu instancia de Looker, lo que te permite corregir todos los casos en una sola operación.
- Si agrupas por Carpeta o Contenido, los botones se aplican a un caso del error en una sola vista o mosaico, lo que te permite considerar cada caso del error por separado.
Por ejemplo, una tabla de errores se agrupa por Error y muestra tres instancias de contenido con una exploración desconocida llamada customers. La acción que se proporciona para los tres elementos de contenido es Replace. Si haces clic en Replace, se verán afectadas las tres instancias de contenido con el error 3 x Unknown explore 'customers'.
En algunos casos, pueden existir varios errores en los contenidos. Por ejemplo, una tabla de errores se agrupa por Contenido y muestra un contenido llamado Detalles del pedido. Se muestran cuatro errores Unknown field en la columna Errores, y cada error tiene sus propios botones de acción Replace y Remove en la columna Actions.
Además, si agrupas por Contenido, tienes la opción adicional de borrar las vistas.
Reemplazar nombres de campos, vistas, Exploraciones y modelos
Los resultados de la validación de contenido incluyen un botón Reemplazar para los siguientes tipos de elementos a fin de poder cambiarles el nombre:
- Nombres de los modelos en las Vistas y en los mosaicos del panel
- Explora los nombres en las Vistas y los mosaicos del panel
- Ver nombres en filtros personalizados o en cálculos de tablas
- Nombres de las vistas en los mosaicos del panel y las Vistas
- Nombres de campos:
- En la sección Datos de una vista
- En un mosaico de panel basado en consultas
- Se hace referencia en los cálculos de tablas
- Se hace referencia en los filtros personalizados
- Se hace referencia en los campos personalizados
- Se hace referencia en los parámetros de configuración de visualización, como el área Personalizaciones de la pestaña Serie para los gráficos de columnas.
- Se hace referencia a través de un mosaico de panel para escuchar un filtro de panel (esto se configura en la pestaña Tiles to Update de la ventana de configuración del filtro, que se describe en la página de documentación Cómo agregar y editar filtros de panel definidos por el usuario).
Para cualquiera de estos errores, puedes usar el Validador de contenido para reemplazar un atributo del contenido que sea igual o más general que el atributo que genera el error:
- Si un campo tiene errores, puedes reemplazarlo o quitarlo, o puedes reemplazar la vista, Explorar o el nombre del modelo.
- Si hay un error en el nombre de una exploración, puede reemplazar el nombre de la exploración o el del modelo.
- Si el nombre de un modelo tiene errores, puedes reemplazarlo.
A continuación, se muestra cómo usar el Validador de contenido para reemplazar los nombres de los elementos en tu modelo:
- Haz clic en Validar para ejecutar el Validador de contenido.
- Selecciona una opción de configuración de Agrupar por para elegir cómo se agrupan los errores. Por ejemplo, puedes agrupar por Error para ajustar varios elementos al mismo tiempo.
En la tabla de errores, haz clic en el botón Replace junto al error que deseas corregir para abrir el diálogo Update in Content.
En la sección Tipo (Type) del diálogo Actualizar en el contenido (Update in Content), selecciona el tipo de elemento de LookML que quieres cambiar: campo, vista, Explorar o modelo. Looker muestra las opciones adecuadas para cada error.
En la sección Nombre, verifica el nombre del elemento que quieres reemplazar. El Validador de contenido completa esta información automáticamente.
En la sección Nombre del reemplazo, ingresa el nombre nuevo del elemento.
Si agrupó según Error y varios elementos se verán afectados, haga clic en Mostrar contenido para ver una lista de los elementos que actualizará el Validador de contenido.
Si lo desea, puede desmarcar las casillas de verificación junto a los elementos de la lista para que no se modifiquen los nombres.
Para realizar el cambio, haz clic en Reemplazar.
Quita el nombre de un campo
Para los errores con nombres de campo en la sección Datos de una vista o un mosaico, la tabla de errores proporcionará el botón Quitar a la derecha del error. Puedes usar el Validador de contenido para quitar campos que tengan las siguientes características:
- En la sección Datos de una vista o un mosaico del panel
- Se hace referencia en los parámetros de configuración de visualización, como el área Personalizaciones de la pestaña Serie para los gráficos de columnas.
- Se hace referencia a través de un mosaico de panel para escuchar un filtro de panel (esto se configura en la pestaña Tiles to Update de la ventana de configuración del filtro, que se describe en la página de documentación Cómo agregar y editar filtros de panel definidos por el usuario).
No puedes usar el validador de contenido para quitar campos de filtros personalizados, campos personalizados o cálculos de tabla, ya que, por lo general, debes realizar cambios adicionales para que la expresión siga funcionando. En su lugar, usa los mensajes de error de validación de contenido para encontrar lugares en los que los filtros personalizados, los campos personalizados y las expresiones de cálculo de tablas deben corregirse y, luego, vuelve a procesar la expresión según corresponda.
- Haz clic en Validar para ejecutar el Validador de contenido.
- Selecciona una opción de configuración de Agrupar por para elegir cómo se agrupan los errores. Por ejemplo, puedes agrupar por Error para ajustar varios elementos (vistas, mosaicos o ambos) al mismo tiempo.
En la tabla de errores, haz clic en Remove junto al error de campo que deseas corregir para abrir el diálogo Remove Field from Content.
En la sección Campo del diálogo Quitar campo del contenido, verifica el nombre del elemento que quieres quitar. El Validador de contenido lo completará automáticamente.
Si agrupaste por Error y hay varios elementos (vistas, mosaicos o ambos), puedes hacer clic en Mostrar contenido para ver una lista de los elementos que actualizará el Validador de contenido.
De manera opcional, puedes desmarcar las casillas de verificación junto a las Vistas o los mosaicos para dejar los nombres sin modificar.
Haz clic en Quitar campo para realizar el cambio.
Borrando vistas
Si agrupas la tabla de errores por Contenido, tienes la opción de borrar las vistas en la tabla.
Sigue estos pasos para usar el Validador de contenido y borrar las vistas:
- Haz clic en Validar para ejecutar el Validador de contenido.
- Agrupa la tabla por Contenido.
- En la tabla de errores, haz clic en el cuadro Seleccionar junto a la vista que deseas borrar.
- Haz clic en Borrar todas las vistas seleccionadas.
- Haz clic en Aceptar en el cuadro de confirmación para borrar la vista o las vistas seleccionadas.
Cómo usar el Validador de contenido para buscar y reemplazar
El Validador de contenido también se puede usar para buscar y reemplazar los nombres de modelos, Exploraciones y campos. Por ejemplo, puedes decidir que prefieres un campo por sobre otro y quieres realizar ese reemplazo en tu proyecto, aunque no haya un error. La lista completa de elementos que el Validador de contenido puede buscar o reemplazar se puede encontrar en la sección Cómo reemplazar nombres por campos, vistas, exploraciones y modelos.
Sigue estos pasos para usar el Validador de contenido como herramienta para buscar y reemplazar:
- En la pantalla del Validador de contenido, haz clic en Buscar y reemplazar en todo el contenido para abrir el diálogo Actualizar en el contenido.
- Selecciona el Tipo de elemento de LookML que quieres cambiar (campo, vista, Explorar o modelo).
- Ingresa el Nombre del elemento que quieres reemplazar.
- En Replacement Name, ingresa un nombre para el campo, la vista, la Exploración o el modelo.
- Haz clic en Reemplazar (Replace) para realizar el cambio.
Aspectos para tener en cuenta
Planifica volver a ejecutar la validación de contenido para ver los resultados de las correcciones que realices.
Ten en cuenta lo siguiente sobre el Validador de contenido:
- Puedes cambiar sus nombres a las vistas, las exploraciones o los modelos, pero no quitarlos por completo. Consulta la sección Cómo quitar el nombre de un campo para obtener una lista de los elementos que se pueden quitar con el Validador de contenido.
- Los cálculos basados en tablas solo pueden hacer referencia a campos que se incluyen en la consulta de una vista o una tarjeta. Esto significa que si quitas un campo de una vista o una consulta de mosaico, pero un cálculo basado en tablas aún usa ese campo, recibirás un nuevo error de validación de contenido.
- No se validarán las vistas que se borraron y están en la página Papelera. Si quieres validar una vista borrada, primero el administrador de Looker debe restablecerla.
- Si estás en Modo de desarrollo, los resultados de la validación reflejarán tu LookML guardado, incluso si no se envió a producción. Sin embargo, cualquier cambio que realices con el Validador de contenido afectará a los usuarios que vean el contenido en el modo de producción. Considera cambiar al modo de producción antes de ejecutar el Validador de contenido.