Validación de contenido

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 el contenido de Looker. Es una herramienta útil para validar tus referencias de LookML, corregir errores en tu 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 Content Validator en el menú Develop, que se encuentra en el panel de navegación izquierdo. Desde aquí, puedes usar el validador de contenido de dos maneras:

Antes de usar el Validador de contenido

Debes tener extremely cuidado cuando realices cambios mediante la validación de contenido. El Validador de contenido no tiene una función de deshacer y tiene el potencial de afectar muchas vistas y paneles, junto con sus vínculos Explorar desde aquí. Si cometes un error, debes intentar corregirlo lo antes posible, antes de que los cambios adicionales dificulte aislar las vistas afectadas.

Además, ten en cuenta los plazos para usar 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, para que no funcionen por el tiempo mínimo. Si corriges las vistas y los mosaicos demasiado pronto, en función de tu trabajo en el Modo de desarrollo, los usuarios no los verán hasta que apliques los cambios. Del mismo modo, si retrasas la corrección de las vistas y los mosaicos hasta mucho después de aplicar los cambios, las vistas y los mosaicos aparecerán rotos para los usuarios 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 que resultan de cambios en LookML. Por ejemplo, si cambias el nombre de un campo de customer a user, las vistas o los mosaicos del panel que incluían el campo customer ya no funcionarán (a menos que hayas usado el parámetro alias). El Validador de contenido enumerará cualquier referencia al campo customer y también proporcionará una manera fácil de corregir el error.

Cuando ejecutas el validador de contenido, este valida todas las referencias que hacen tus vistas y paneles a tus modelos, exploraciones, vistas y campos de LookML, y mostrará un error para cualquier referencia que tu contenido haga a un objeto de LookML desconocido.

El validador de contenido no muestra los siguientes errores:

  • Contenido para el que no tienes permiso de develop El validador de contenido se limita a tus permisos, de modo que solo puedes usarlo en el contenido para el que tienes el permiso develop (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 del modelo.
  • Las vistas que se borraron y están en la papelera. Si quieres validar una vista borrada, el administrador de Looker debe restablecerla primero.

Cómo ejecutar el validador de contenido

Para validar tu LookML con el validador de contenido, sigue estos pasos:

  1. Haz clic en Validate.
  2. Selecciona la pestaña Agrupar por para cambiar la forma en que se agrupan los errores:
    • Error: Enumera cada error y agrupa el contenido de Looker que tiene el error. Esto es útil si quieres corregir el mismo error en varios elementos de contenido a la vez.
    • Carpeta: Enumera 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: Enumere cada contenido que tenga errores y agrupe sus errores. Esto es útil si quieres corregir todos los errores en una sola vista, mosaico, filtro, etcétera.
  3. Si estás en Modo de desarrollo, Looker mostrará un mensaje de advertencia. Es importante comprender las implicaciones de los cambios en las vistas y los mosaicos. Si los "corrígelos" antes de publicar los cambios rotundos, habrá un período en el que la corrección es prematura, por lo que los usuarios experimentarán vistas o mosaicos rotos. El mensaje de advertencia te ayuda a recordar esto.
  4. La tabla de errores muestra cualquier error, junto con una lista de las vistas y los mosaicos que contienen el error, además del modelo subyacente y la exploración 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.
  5. Looker proporciona los botones Reemplazar o Quitar para cada fila, según el tipo de error. Estos botones, que proporcionan una funcionalidad que permite corregir los errores, se describen con más detalle a continuación.

Visualización de los resultados de validación de contenido

Los resultados de la validación de contenido muestran contenido de Looker que usa nombres de modelos, nombres de exploraciones, nombres de vistas o nombres de campos que no existen o no se pueden encontrar. Consulta la sección Cómo usar el validador de contenido para corregir errores a fin de obtener detalles sobre los elementos de LookML que el validador de contenido puede encontrar y validar.

El ícono que aparece junto al nombre del contenido identifica el tipo de contenido:

  • Mosaico en el ícono del panel.: Mosaico del panel
  • Ícono de alerta en el panel.: Alerta del panel
  • Ícono de Programar en el panel o Programar en la vista.: Programa una vista o un panel
  • Ícono de filtro en el panel.: 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 quieres 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 todos los elementos de LookML que se enviaron 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 la falta de una unión.

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 Reemplaza los nombres por campos, vistas, exploraciones y modelos más adelante en esta página para conocer cómo reemplazar nombres con el validador de contenido).
  • Quitar: En el caso de errores con nombres de campo en la sección Datos de una vista o mosaico, Looker también muestra el botón Quitar (consulta la sección Quita un nombre de campo más adelante en esta página para descubrir cómo quitar nombres con el validador de contenido).

Según el parámetro de configuración 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 aplicarán 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 por 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 proporcionada para los tres elementos de contenido es Replace. Si haces clic en Reemplazar, se verán afectadas las tres instancias de contenido con el error 3 x Unknown explore 'customers'.

En algunos casos, pueden existir varios errores relacionados con el contenido. 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 Errors y cada error tiene sus propios botones de acción Replace (Reemplazar) y Remove (Quitar) en la columna Actions (Acciones).

Además, si agrupas por Contenido, tendrás la opción adicional de borrar las vistas.

Reemplazar los nombres de los campos, las vistas, las exploraciones y los modelos

Los resultados de validación de contenido incluyen el botón Reemplazar para los siguientes tipos de elementos, de modo que puedas cambiarles el nombre:

En caso de 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 presenta errores, puedes reemplazarlo o quitarlo, o bien reemplazar la vista, la exploración o el nombre del modelo.
  • Si hay un error en el nombre de una exploración, puedes reemplazar el nombre de esta o el del modelo.
  • Si el nombre de un modelo tiene un error, puedes reemplazarlo.

Aquí te mostramos cómo utilizar el validador de contenido para reemplazar los nombres de elementos en tu modelo:

  1. Haz clic en Validar para ejecutar el Validador de contenido.
  2. Selecciona el parámetro de configuración Agrupar por para elegir cómo se agrupan los errores. Por ejemplo, puedes agrupar por Error para poder ajustar varios elementos al mismo tiempo.

  3. 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.

  4. En la sección Tipo del diálogo Actualización en el contenido, selecciona el tipo de elemento de LookML que quieres cambiar: campo, vista, exploración o modelo. Looker muestra las opciones adecuadas para cada error.

  5. En la sección Nombre del campo, verifica el nombre del elemento que quieres reemplazar. El validador de contenido completa esta información automáticamente.

  6. En la sección Nombre del campo de reemplazo, ingresa el nombre nuevo del elemento.

  7. Si agrupaste por Error y hay varios elementos que se verán afectados, puedes hacer clic en Mostrar contenido para ver una lista de los elementos que actualizará el validador de contenido.

  8. De manera opcional, puedes desmarcar las casillas junto a los elementos de la lista para dejar sus nombres sin cambios.

  9. Para realizar el cambio, haz clic en Reemplazar.

Quita el nombre de un campo

En el caso de 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 con las siguientes características:

  • En la sección Datos de un mosaico de vista o panel
  • Se hace referencia a ellos en las configuraciones de visualización, como el área Personalizaciones de la pestaña Serie para 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 Agrega y edita filtros en el panel definidos por el usuario).

No puedes usar el validador de contenido para quitar campos de los filtros personalizados, los campos personalizados o los cálculos de tablas, 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 se deban corregir los filtros personalizados, los campos personalizados y las expresiones de cálculo basado en tablas y, luego, vuelve a trabajar la expresión según corresponda.

  1. Haz clic en Validar para ejecutar el Validador de contenido.
  2. Selecciona el parámetro de configuración Agrupar por para elegir cómo se agrupan los errores. Por ejemplo, puedes agrupar por Error para poder ajustar varios elementos (vistas, mosaicos o ambos) al mismo tiempo.

  3. En la tabla de errores, haz clic en Quitar junto al error de campo que deseas corregir para abrir el diálogo Quitar del contenido.

  4. En la sección Campo del diálogo Quitar campo del contenido, verifica el nombre del elemento que quieres quitar. El validador de contenido la completa automáticamente.

  5. 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.

  6. De manera opcional, puedes desmarcar las casillas de verificación junto a las vistas o los mosaicos para dejar sus nombres sin cambios.

  7. 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 de la tabla.

Si quieres usar el validador de contenido para borrar las vistas, sigue estos pasos:

  1. Haz clic en Validar para ejecutar el Validador de contenido.
  2. Agrupa la tabla por Contenido.
  3. En la tabla de errores, haz clic en el cuadro Seleccionar junto a la vista o las vistas que deseas borrar.
  4. Haz clic en Borrar todas las vistas seleccionadas.
  5. 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 sobre otro y realizar ese reemplazo en tu proyecto, aunque no haya error. La lista completa de los elementos que el validador de contenido puede buscar o reemplazar se encuentra en la sección Cómo reemplazar los nombres de los campos, las vistas, las exploraciones y los modelos.

Sigue estos pasos para usar el Validador de contenido como herramienta de búsqueda y reemplazo:

  1. En la pantalla del validador de contenido, haz clic en Find & Replace in All Content para abrir el diálogo Update in Content.
  2. Selecciona el Tipo de elemento de LookML que quieres cambiar (campo, vista, exploración o modelo).
  3. Ingresa el Nombre del elemento que quieres reemplazar.
  4. Ingresa un Nombre de reemplazo para el campo, la vista, la exploración o el modelo.
  5. Haz clic en Reemplazar 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 los nombres de las vistas, las exploraciones y los modelos, pero no puedes quitar los nombres por completo. Consulta la sección Cómo quitar un nombre de campo para obtener una lista de los elementos que puedes quitar con el validador de contenido.
  • Los cálculos basados en tablas solo pueden hacer referencia a campos que están incluidos en la consulta de una vista o un mosaico. Esto significa que, si quitas un campo de una consulta de vista o mosaico, pero un cálculo basado en tablas aún usa ese campo, aparecerá un nuevo error de validación de contenido.
  • No se validarán las vistas que se hayan borrado y que se encuentren en la página Papelera. Si quieres validar una vista borrada, el administrador de Looker debe restablecerla primero.
  • 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 ven contenido en modo de producción. Considera cambiar al modo de producción antes de ejecutar el validador de contenido.