Configuración del administrador: Tablas derivadas persistentes

En la página de administración Tablas derivadas persistentes de Looker, se muestra el estado de las tablas persistentes de la instancia de Looker (que incluyen tablas derivadas persistentes y tablas agregadas).

La página del administrador Tablas derivadas persistentes muestra varias funciones de administración que pueden ayudar a hacer un seguimiento del comportamiento de las tablas persistentes y solucionar problemas relacionados. Consulta la página de documentación Tablas derivadas en Looker para obtener información sobre la solución de problemas relacionados con las tablas persistentes.

Los administradores de Looker y los usuarios con el permiso see_pdts pueden acceder a la página Tablas derivadas persistentes.

Para abrir la página Tablas derivadas persistentes, sigue estos pasos:

  1. Haz clic en el ícono del menú principal de Looker y selecciona Administrador si aún no se muestra el menú Administrador. (Si estás en la sección Explorar o Desarrollar del menú principal de Looker, es posible que debas hacer clic en la flecha hacia atrás para ver el menú Administrador).
  2. En el menú Administrador, selecciona Tablas derivadas persistentes.

En la página Tablas derivadas persistentes, solo se muestran las conexiones que están habilitadas para las PDT y solo las tablas persistentes que cumplen con los siguientes criterios:

  • La tabla persistente se define en un archivo de vista que está en producción, a menos que estés en el Modo de desarrollo, en cuyo caso puedes usar la pestaña Desarrollo para ver la versión de desarrollo de las tablas persistentes.
  • La tabla persistente forma parte de un modelo que está configurado correctamente.
  • La tabla persistente forma parte de un modelo al que tienes acceso a los datos.

La información de esta página se basa en un registro de eventos de PDT interno, que se describe en la sección Explorar registro de eventos de PDT en esta página.

Personaliza la tabla

De forma predeterminada, la página Tablas derivadas persistentes muestra un máximo de 25 tablas persistentes en la página y carga tablas persistentes para todas las conexiones para las que tienes acceso a los datos en la instancia de Looker. Existen varias formas de cambiar los datos que se muestran en la tabla:

  1. Para ver solo las tablas persistentes de una conexión específica, haz clic en la flecha junto a Todas las conexiones y, luego, selecciona el nombre de la conexión específica. El selector solo muestra las conexiones que están habilitadas para los PDT y a las que tienes acceso a los datos.
  2. Ingresa palabras clave en el cuadro de búsqueda para limitar la lista de tablas persistentes a aquellas cuyos nombres incluyen la palabra clave. La tabla mostrará las tablas persistidas con el término de búsqueda coincidente en negrita. Haz clic en la X de la barra de búsqueda para borrar los términos de tu búsqueda.
  3. Haz clic en el ícono de Filtros para definir un filtro para la tabla.
  4. Haz clic en el ícono de cerrar/abrir para mostrar o ocultar la sección De un vistazo.
  5. Haz clic en el nombre de una columna para ordenar la tabla según esa columna. Haz clic en el nombre de la columna por segunda vez para invertir el orden de clasificación.
  6. Haz clic en el ícono Seleccionar columnas para mostrar para ocultar o mostrar columnas en la tabla.
  7. Usa el selector de visualización para elegir la cantidad de resultados que se muestran en una sola página. Si la tabla es más larga que una sola página, puedes hacer clic en las flechas que se encuentran en la parte inferior central de la página para navegar a la página siguiente o anterior.

Filtros

Puedes usar el ícono Filtros junto a la barra de búsqueda para elegir qué tablas persistentes se muestran en la página Tablas derivadas persistentes. Por ejemplo, puedes filtrar por Last Build Status para ver solo las tablas persistentes que tienen un error de compilación, o bien puedes filtrar por Model para limitar las tablas persistentes que se muestran a un modelo específico.

Para filtrar la página Tablas derivadas persistentes, sigue estos pasos:

  1. Haz clic en el ícono de Filtros .
  2. Selecciona una opción de filtro en el primer selector de filtros del menú de filtros. Las siguientes opciones están disponibles:
    • No se activó en el último: Filtra la página Tablas derivadas persistentes por tablas persistentes que no se activaron en una cantidad especificada de horas y minutos.
    • Activado en el último: Filtra la página Tablas derivadas persistentes por tablas persistentes que se activaron en una cantidad especificada de horas y minutos.
    • Modelo: Filtra la página Tablas derivadas persistentes para las tablas persistentes que se incluyen en un modelo especificado.
    • Regla de persistencia: Filtra la página Tablas derivadas persistentes por tipo de persistencia.
    • Estado del último intento: Filtra la página Tablas derivadas persistentes por un estado de tabla persistente especificado.
    • Publicadas como vista estable: Es un valor booleano que filtra la página Tablas derivadas persistentes en busca de tablas persistentes y muestra para las tablas persistentes que se publicaron como una vista estable y No para las tablas persistentes que no se publicaron como una vista estable, según lo determine el valor del parámetro publish_as_db_view.
    • Duración de la última compilación fue mayor que: Filtra la página Tablas derivadas persistentes por tablas persistentes cuyas compilaciones tardaron más que una cantidad especificada de segundos.
    • Proyecto: Filtra la página Tablas derivadas persistentes por tablas persistentes del proyecto de LookML especificado.
  3. Elige el valor por el que deseas filtrar la página Tablas derivadas persistentes en el segundo selector de filtros. En las opciones No activado en el último o Activado en el último, ingresa una cantidad de horas o minutos. En la opción Duración de la última compilación fue mayor que, ingresa una cantidad de segundos.
  4. Haz clic en Agregar filtro para agregar más filtros y repite los pasos 2 y 3 para cada filtro que agregues.
    • Para borrar las selecciones de filtros y comenzar de nuevo en cualquier momento, haz clic en Borrar todo.
    • Para quitar filtros adicionales individuales, haz clic en la opción Borrar del filtro que deseas quitar.
  5. Para aplicar los criterios de filtro seleccionados a la página Tablas derivadas persistentes, haz clic en Aplicar.

Verás los filtros aplicados en la parte superior de la página Tablas derivadas persistentes.

Haz clic en la X junto a un filtro aplicado en la página Tablas derivadas persistentes para quitarlo de la página Tablas derivadas persistentes. Haz clic en Borrar todo para borrar todos los filtros.

Información sobre la página Tablas derivadas persistentes

En las siguientes secciones, se describe la información de la página Tablas derivadas persistentes.

Pestañas Producción y Desarrollo

Si eres desarrollador de LookML en el Modo de desarrollo, la tabla Tablas derivadas persistentes tendrá dos pestañas:

  • La pestaña Producción está seleccionada de forma predeterminada y muestra las tablas persistentes de producción. Estas son las tablas persistentes que se implementaron en producción en tu instancia. Estas tablas persistentes proporcionan los datos para las consultas de Explorar de tus usuarios. (Si estás en el Modo de producción o no tienes permisos de develop, la página Tablas derivadas persistentes no mostrará ninguna pestaña y solo mostrará información de las tablas persistentes de producción).

  • En la pestaña Desarrollo, se muestran las tablas persistentes de desarrollo. Las tablas persistentes de desarrollo aún no se enviaron al entorno de producción.

Looker crea una tabla persistente de desarrollo cuando un desarrollador de LookML en el modo de desarrollo realiza cambios que afectan los datos de la tabla persistente o la forma en que se consulta. Estos cambios le indican a Looker que crea la tabla persistente de desarrollo, pero no la compila, a menos que se consulte después de realizar los cambios. La pestaña Desarrollo puede ayudarte a determinar qué tablas persistentes de desarrollo creó Looker y si se compilaron.

Consulta la página de documentación Tablas derivadas en Looker para obtener más información sobre qué le indica a Looker que cree tablas persistentes de desarrollo y durante cuánto tiempo se conservan en tu base de datos.

Sección De un vistazo

En la sección De un vistazo, se muestra un resumen visual del estado de las tablas persistentes que se muestran en la tabla de tablas persistentes. Si definiste filtros para la tabla o usaste la flecha junto a Todas las conexiones en la parte superior de la página para limitar la tabla a una conexión específica, la sección De un vistazo restringirá los resultados para que coincidan con lo que se muestra en la tabla persistente.

Para ocultar o mostrar la sección De un vistazo, haz clic en el ícono de cerrar o abrir que se encuentra en la parte superior de la sección.

Columnas de la tabla

En las siguientes secciones, se describen las columnas de la tabla de la página Tablas derivadas persistentes. Haz clic en el ícono Seleccionar columnas que se mostrarán para ocultar o mostrar algunas de las columnas de la tabla. Para obtener más información, consulta la sección Cómo personalizar la tabla en esta página.

Nombre de la PDT

La columna PDT Name muestra el nombre de la tabla persistente, tal como se define en el parámetro view del archivo de vista de LookML de la tabla persistente.

La columna PDT Name muestra esta información adicional debajo del nombre de la tabla persistente, cuando corresponda:

  • Compilación anterior indica que la fila muestra información sobre una compilación de tabla persistente anterior. Consulta el diálogo Detalles de PDT en el menú Opciones para obtener más información sobre este mensaje.
  • Incremental indica que la tabla persistente es una PDT incremental.
  • Vista materializada indica que la tabla persistente es una vista materializada en tu base de datos.

Estado del último intento

La columna Last Attempt Status muestra el estado del último intento de compilar cada tabla persistente que se indica:

  • Regenerar indica que se puede consultar la tabla persistente y que se está compilando una tabla actualizada. Una marca de tiempo indica cuándo comenzó a compilarse la tabla persistente.
  • Correcto indica que se creó correctamente una tabla persistente.
  • Compilando indica que se está compilando una tabla persistente y que no se puede consultar hasta que se complete la compilación.
  • No compilada indica que no se compiló una tabla persistente.
  • Error de compilación indica que se produjo un error durante una compilación. Puedes hacer clic en Error de compilación para ver la fuente del error y navegar al código LookML de la tabla persistente si tienes los permisos adecuados para ver LookML. Consulta la sección Menú de opciones en esta página para obtener más información sobre la solución de problemas de las tablas persistentes en la página Tablas derivadas persistentes.

Último intento

La columna Last Attempted At indica la hora del último intento de compilación de la tabla persistente.

Última compilación correcta

La columna Última compilación correcta indica la hora de la última compilación correcta de la tabla persistente.

Duración de la última compilación

En la columna Last Build Duration, se muestra la cantidad de tiempo en segundos que tardó la compilación más reciente de esa tabla persistente y el tiempo que tarda en compilarse la tabla persistente en promedio en segundos.

Regla de persistencia

La columna Persistence Rule muestra el tipo de persistencia que se aplica a una tabla persistente, como se especifica en la definición de LookML de la tabla persistente. También indica la última vez que se verificó una tabla persistente compilada correctamente (para tablas persistentes de tipo activador) o cuándo vencerá una tabla persistente compilada correctamente (para tablas persistentes de tipo persistente). Hay dos tipos de persistencia que se muestran en la columna Persistence Rule:

  • Persistir durante: (tiempo) se muestra para las tablas persistentes que se conservan con el parámetro persist_for.
  • Activador: (nombre del grupo de datos) se muestra para las tablas persistentes que se conservan con un parámetro datagroup_trigger. Puedes hacer clic en el vínculo del nombre del grupo de datos para ver el valor sql_trigger del parámetro datagroup.
  • Activador: SQL se muestra para las tablas persistentes que se conservan con un parámetro sql_trigger_value. Puedes hacer clic en el vínculo para ver la declaración de sql_trigger_value.
  • Vista materializada se muestra para las vistas materializadas, que aprovechan la funcionalidad de tu base de datos para conservar las tablas derivadas en ella.

Proyecto

La columna Project indica el nombre del proyecto de LookML en el que se define la tabla persistente.

Conexión

Si se selecciona Todas las conexiones en la selección de conexión, aparecerá la columna Conexión y se mostrará el nombre de la conexión en la que está habilitada la tabla persistente.

Modelo

La columna Model muestra el nombre del archivo de modelo asociado con la tabla persistente. En el caso de un PDT, este suele ser el archivo de modelo que incluye el archivo de vista en el que se define el PDT. En el caso de una tabla conjunta, suele ser el archivo de modelo en el que se define la tabla conjunta.

Menú de opciones

El menú de tres puntos Opciones es especialmente útil para solucionar problemas de comportamiento inesperado. Las opciones que presenta te permiten verificar cuándo se compilaron las tablas por última vez, verificar cuánto tiempo tardaron en compilarse, comparar el tiempo de compilación más reciente con el tiempo de compilación promedio y verificar si los activadores funcionan correctamente. Puedes elegir entre las siguientes opciones:

  • Ir a LookML: Abre el archivo de vista en el que se define la tabla persistente si tienes los permisos adecuados para ver LookML.
  • Panel de actividad de PDT: Abre el panel Actividad de PDT, que se filtra para mostrar la actividad de la tabla persistente seleccionada durante las últimas cuatro semanas.
  • Detalles de PDT: Abre un diálogo que contiene más información y estadísticas de una tabla persistente específica. Consulta la sección Diálogo modal de detalles de PDT en esta página para obtener más información.

Consulta la sección de supervisión y solución de problemas de los PDT en la página de documentación Tablas derivadas en Looker para obtener sugerencias de solución de problemas.

Ventana modal de detalles de la PDT

Haz clic en la opción Detalles de PDT en el menú de tres puntos Opciones de la tabla persistente para ver el cuadro modal de detalles de PDT.

La información del cuadro modal depende de la configuración de la tabla persistente. Esta es la información que podrías ver:

  • Nombre de la tabla: Es el hash de la tabla persistente más reciente que se compiló correctamente.
  • Modelo: Es el nombre del archivo de modelo en el que se incluye el archivo de vista de la tabla persistente.
  • Nombre estable: Es el nombre de la vista de base de datos estable de la tabla persistente en tu base de datos, si la tabla persistente se publicó como una vista estable. Para publicar una tabla persistente como una vista estable en tu base de datos, agrega la sentencia publish_as_db_view: yes a la PDT o a la tabla agregada, o usa la sentencia materialized_view: yes para hacer que la tabla derivada sea una vista materializada.
  • Connection: Es el nombre de la conexión en la que está habilitada la tabla persistente.
  • Compilación anterior: Es un valor booleano que muestra si una compilación es una compilación de tabla persistente anterior o No si no lo es.
    • Tipo de tabla: En las compilaciones anteriores, aparece este campo y muestra el tipo de tabla. Los valores incluyen Tabla de generación anterior y Reemplazo.
  • PDT incremental: Es un valor booleano que muestra si una tabla persistente es una PDT incremental o No si no lo es.
  • Estado: Muestra el Estado del último intento. En el caso de las compilaciones que fallan, proporciona un mensaje de error de SQL y un vínculo al LookML del modelo si el usuario tiene los permisos adecuados para ver LookML.
  • Dependencias: Haz clic en el botón Mostrar gráfico de dependencias para mostrar un diagrama de relaciones de todas las tablas derivadas de las que depende esta tabla persistente. Cada nodo del diagrama corresponde a una tabla derivada. El color de cada nodo corresponde al estado de esa tabla derivada, como se indica a continuación:
    • Un nodo verde representa una tabla persistente que se compiló correctamente.
    • Un nodo amarillo representa una tabla persistente que se está compilando o incrementando.
    • Un nodo rojo representa una tabla persistente que no se pudo compilar.
    • Un nodo gris representa una tabla persistente que aún no se compila.
    • Un nodo blanco representa una tabla derivada temporal, que Looker no compila.
  • Compilación más reciente:
    • Última compilación correcta: La fecha y hora de la compilación correcta más reciente de la tabla persistente.
    • Duración de la compilación más reciente: Indica cuánto tiempo tardó la compilación más reciente de la tabla persistente (en segundos; muestra si la tabla aún no se compiló).
    • Duración promedio de compilación: Indica cuánto tiempo tarda en compilarse la tabla persistente en promedio (en segundos; muestra si la tabla aún no se compiló).
    • Motivo de compilación: El motivo por el que se compiló una tabla persistente (inception para una compilación inicial; datagroup triggered si la tabla persistente se conserva con un grupo de datos; trigger value change si cambió el valor del activador de SQL de la tabla persistente).
    • Clave de incremento: Es el parámetro increment_key para las tablas persistentes que usan compilaciones incrementales.
    • Desplazamiento de incremento: Es el parámetro increment_offset para las tablas persistentes que usan compilaciones incrementales.
    • Filas agregadas o quitadas de la compilación incremental: Es la cantidad de filas que se agregaron o quitaron de la tabla cuando se incrementó por última vez (se muestra si no se agregaron ni quitaron filas cuando la estrategia de persistencia de la tabla activó un incremento por última vez).
    • SQL del último intento: Es la sentencia SQL que se usó para consultar la base de datos y crear la última compilación de la tabla.
  • Regla de persistencia:
    • Type: Es el tipo de persistencia que usa la tabla. Consulta la sección Columna Persistence Rule en esta página para conocer los valores posibles.
    • Persist For: Para las tablas persistentes de tipo Persist, el valor de duración de la persistencia. No se aplica a las tablas persistentes de tipo Trigger.
    • Datagroup: En el caso de las tablas persistentes del activador de grupos de datos, proporciona el nombre del grupo de datos.
    • Bloque de código SQL: En el caso de las tablas persistentes de grupos de datos y activadores de SQL, el bloque de código mostrará la sentencia SQL del activador. En el caso de los activadores de grupos de datos, este es el SQL para el parámetro sql_trigger del grupo de datos. En el caso de los activadores de SQL, este es el SQL para el parámetro sql_trigger_value.
    • Valor del activador: En el caso de las tablas persistentes de tipo Trigger, es el valor que activó la compilación de la tabla persistente (se muestra para las tablas persistentes compiladas correctamente que se conservan con un datagroup_trigger. Para ver el valor del activador más reciente de un grupo de datos, consulta la página Datagroups en el panel Administrador).
    • Fecha de la última verificación: En el caso de las tablas persistentes de tipo Trigger, indica la fecha en la que se verificó el valor del activador por última vez.
    • Expires: Es la fecha de vencimiento de la tabla persistente, si corresponde (no se aplica a los activadores de grupos de datos).

Panel de actividad de PDT

En el panel PDT Activity, se muestra información sobre la tabla persistente, sus recomposiciones y sus consultas.

De forma predeterminada, el panel Actividad de PDT muestra información de la actividad de las cuatro semanas anteriores. Puedes cambiar el período que se muestra con la barra de filtros que se encuentra en la parte superior del panel. El panel PDT Activity incluye tarjetas que muestran la siguiente información:

  • Un resumen de la tabla persistente que incluye el nombre del modelo y la vista de LookML que definen la tabla persistente, el nombre de la conexión de la base de datos que usa la tabla persistente, la cantidad total de intentos de compilación exitosos y fallidos de la tabla persistente, y el porcentaje de intentos de compilación totales que fallaron.
  • Es la fecha y hora de la última reconstrucción completa de la tabla persistente.
  • Si la tabla persistente es una PDT incremental, la fecha y hora de la recompilación incremental más reciente de la PDT
  • Si la tabla conservada es un PDT incremental, la cantidad de recompilaciones incrementales que se produjeron desde la compilación completa más reciente
  • Es el tiempo promedio que se tarda en volver a crear la tabla persistente.
  • Una visualización que muestra todos los eventos de creación que se produjeron recientemente, agrupados por un resumen de los tipos de acciones que los causaron.
  • Es una lista de todas las recompilaciones de tablas persistentes que se produjeron durante el período del panel, incluida la fecha en que se completó cada compilación, la cantidad de segundos que se tardaron en completar cada compilación, si las compilaciones fueron incrementales, el activador que causó cada compilación y la cantidad de compilaciones de tablas persistentes.
  • Una lista de todos los intentos de reconstrucción fallidos, incluida la fecha y hora en que comenzó la reconstrucción fallida, el tipo de error que causó la falla, el mensaje de error y la cantidad de fallas de creación.
  • Es una lista de todos los eventos de activación de la reconstrucción de tablas persistentes, incluidos el número de ID del evento, la fecha del evento, el tipo de evento y los datos que se incluyeron con el evento de activación.
  • Es una lista de todos los eventos de recompilación de tablas persistentes, incluidos el número de ID del evento, la fecha del evento, el tipo de evento y los datos que se incluyeron con el evento de recompilación.
  • Es la cantidad de consultas que consultaron directamente un campo, agrupadas por la fuente de la consulta y el tiempo de ejecución promedio de cada fuente de consulta.
  • Es la cantidad total de consultas que se ejecutaron en la tabla persistente.
  • Es una lista de todos los campos de tabla persistentes consultados, incluida la vista y el modelo de LookML en los que se define el campo, el nombre del campo, el nombre de la ejecución de Explorar que lo incluyó y la cantidad de veces que se incluyó en una consulta.

Exploración del registro de eventos de PDT

Looker incluye un modelo prediseñado llamado system_activity que permite explorar el registro de eventos de PDT, que es una tabla en el esquema temporal de una conexión de base de datos que realiza un seguimiento del activador y compila la actividad de las tablas persistentes.

Puedes acceder al modelo con los vínculos Eventos de compilación recientes y Eventos de activación recientes en el menú de tres puntos Opciones de la página Tablas derivadas persistentes o desde la página Conexiones en el panel Administrador de Looker.

Para acceder a la exploración del registro de eventos de PDT desde la página Conexiones, selecciona la opción Mostrar registro de eventos de PDT en el menú desplegable del ícono de ajustes de cada conexión.

Puedes explorar el modelo como con cualquier otra función de Explorar de Looker. Cuando se accede desde la página Conexiones, la exploración del Registro de eventos de PDT se filtra para toda la conexión. Cuando se accede desde la página Tablas derivadas persistentes, se filtra la exploración del registro de eventos de PDT para una tabla persistente específica.

Esta es una breve guía de los campos disponibles en la exploración del registro de eventos de PDT:

CampoDescripción
AcciónDescribe la acción que se produjo, lo que puede incluir la regeneración, la eliminación, la creación y la actividad de cosecha.

Consulta la página de documentación Información sobre las acciones de registro de PDT para obtener más información sobre cómo ver y comprender las acciones de registro de PDT y sus datos de acción correspondientes.
Datos de acciónProporciona detalles más específicos sobre una acción, incluido el activador que se usa, el valor de un activador, la hora de vencimiento de una tabla persistente, la causa de una reconstrucción y el texto de un mensaje de error.

Consulta la página de documentación Información sobre las acciones de registro de PDT para obtener más información sobre cómo ver y comprender las acciones de registro de PDT y sus datos de acción correspondientes.
ConexiónEs el nombre de la conexión en la que existe la tabla derivada.
HashCada tabla derivada contiene un hash del SQL que se escribió para crearla.
IDEl ID único de la instancia de Looker que generó la tabla persistente. En muchos casos, solo habrá una instancia de Looker que apunte a una base de datos, por lo que solo verás un ID. Sin embargo, si tienes una instancia de pruebas o algo similar, es posible que veas varios IDs.
Nombre del modeloEs el nombre del modelo a través del cual se generó la tabla.
Fecha de ocurrenciaLa fecha y hora en que ocurrió el evento.
Fecha de visualización de UTC de ocurrenciaLa fecha y hora (UTC) en que ocurrió el evento.
SecuenciaEs un número de paso en la compilación de la tabla persistente.
Hash cortoEs una versión truncada del hash del SQL que se escribió para crear la tabla derivada.
Nombre de la tablaEs el nombre completo de la tabla persistente, incluido el prefijo de tipo de tabla, un hash y el nombre de la vista.
TidEl ID de la transacción.
Nombre de la vistaEs el nombre de la vista de la tabla derivada.