Configuración del administrador: Tablas derivadas persistentes

Las funciones de tablas derivadas persistentes (PDT) de Looker te permiten realizar análisis complejos en la plataforma. Looker muestra varias funciones de administrador que pueden ayudar a realizar un seguimiento del comportamiento de PDT y solucionar problemas en él en la página Tablas derivadas persistentes, a las que los administradores y usuarios con los permisos adecuados pueden acceder desde la sección Base de datos del panel Administrador de Looker. (Consulta la página de documentación de Tablas derivadas en Looker para obtener información sobre la solución de problemas de PDT).

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

  • El PDT 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 Development para ver la versión de desarrollo de las tablas persistentes.
  • El PDT forma parte de un modelo que está configurado correctamente.
  • El PDT 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 Modelo de registro de eventos de PDT de esta página.

Personaliza la tabla

De forma predeterminada, la página Tablas derivadas persistentes muestra un máximo de 25 PDT en la página y carga PDT 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. Haz clic en la flecha junto a Todas las conexiones para ver las PDT solo de una conexión específica. El selector solo muestra las conexiones que tienen habilitados los PDT y a las que tienes acceso a los datos.
  2. Escribe palabras clave en el cuadro de búsqueda para limitar la lista de PDT a las PDT cuyos nombres incluyan la palabra clave. La tabla mostrará los PDT 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 la 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 ocultar o mostrar la sección De un vistazo.
  5. Haz clic en el nombre de una columna para ordenar la tabla en función de 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 mostrarán 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 central inferior 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é PDT se muestran en la página Tablas derivadas persistentes. Por ejemplo, puedes filtrar por Last Build Status para ver solo los PDT que tienen un error de compilación, o bien puedes filtrar por Model para limitar los PDT 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 del primer selector de filtros del menú de filtros. Están disponibles las siguientes opciones:
    • No se activó en el último: Filtra la página Tablas derivadas persistentes por las PDT que no se activaron en una cantidad especificada de horas y minutos.
    • Activado en el último: Filtra la página Tablas derivadas persistentes por PDT que se activaron en una cantidad específica de horas y minutos.
    • Modelo: Filtra la página Tablas derivadas persistentes para las PDT incluidas en un modelo especificado.
    • Regla de persistencia: Filtra la página Tablas derivadas persistentes por el tipo de persistencia de la PDT.
    • Estado del último intento: Filtra la página Tablas derivadas persistentes por un estado de PDT especificado.
    • Publicada como vista estable: Es un valor booleano que filtra la página Tablas derivadas persistentes para las PDT y muestra para las PDT que se publicaron como una vista estable y No para las PDT que no se publicaron como vista estable, según lo determinado por su valor del parámetro publish_as_db_view.
    • La duración de la última compilación es mayor que: Filtra la página Tablas derivadas persistentes por PDT cuyas compilaciones tardaron más de una cantidad específica de segundos.
    • Proyecto: Filtra la página Tablas derivadas persistentes por PDT del proyecto de LookML especificado.
  3. Elige el valor en el que quieres filtrar la página Tablas derivadas persistentes en el segundo selector de filtros. Para las opciones No se activó en las últimas o Se activó en las últimas, 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 volver a comenzar 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 quitar el filtro de la página Tablas derivadas persistentes. Haz clic en Borrar todo para borrar todos los filtros.

Información sobre la página de PDT

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 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 PDT de producción. Estos son los PDT que se implementaron en producción en tu instancia. Estos PDT proporcionan los datos para las consultas de Explorar de tus usuarios. (Si estás en Modo de producción o si no tienes los permisos develop, la página Tablas derivadas persistentes no mostrará pestañas, y la página solo mostrará información para las PDT de producción).

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

Looker crea una PDT de desarrollo cuando un desarrollador de LookML en Modo de desarrollo realiza cambios que afectan los datos en la PDT o la forma en que se consulta la PDT. Estos cambios le solicitan a Looker que cree la PDT de desarrollo, pero en realidad no la compila, a menos que se consulte la PDT después de que se realicen los cambios. La pestaña Development puede ayudarte a determinar qué PDT de desarrollo creó Looker y si se compilaron.

Consulta la página de documentación de Tablas derivadas en Looker para obtener más información sobre qué le indica a Looker crear PDT de desarrollo y por cuánto tiempo se conservan las PDT de desarrollo 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 PDT que se muestran actualmente en la tabla de PDT. 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 reducirá los resultados para que coincidan con lo que se muestra en la tabla de PDT.

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 para mostrar 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 de esta página.

Nombre de la PDT

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

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

  • Compilación anterior indica que la fila muestra información sobre una compilación PDT anterior. Para obtener más información sobre este mensaje, consulta la ventana emergente Detalles de PDT en el menú Opciones.
  • Incremental indica que la PDT es una PDT incremental.
  • Vista materializada indica que el PDT es una vista materializada en tu base de datos.

Estado del último intento

En la columna Last Attempt Status, se muestra el estado del último intento de compilar cada PDT enumerada:

  • Regenerating indica que se puede consultar la PDT y que hay una tabla actualizada en proceso de compilación. Una marca de tiempo indica cuándo comenzó a compilarse la PDT.
  • Correcto indica que se compiló correctamente una PDT.
  • Building indica que se está compilando una PDT y no se puede consultar hasta que se complete la compilación.
  • No compilada indica que una PDT no se compiló actualmente.
  • 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 LookML del PDT si tienes los permisos adecuados para ver LookML. Consulta la sección Menú de opciones de esta página para obtener más información sobre la solución de problemas de PDT en la página Tablas derivadas persistentes.

Último intento

En la columna Last Attempted At, se indica la hora de la última compilación de PDT que se intentó.

Última compilación correcta

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

Duración de la última compilación

En la columna Duración de la compilación más reciente (Last Build Duration), se muestra la cantidad de tiempo en segundos que le tomó la compilación más reciente de esa PDT y cuánto tiempo, en promedio, se tardó en segundos para compilar la PDT.

Regla de persistencia

En la columna Regla de persistencia, se muestra el tipo de persistencia que se aplica a una PDT, como se define en el archivo de vista de la PDT. También indica la última vez que se verificó una PDT compilada correctamente (para PDT de tipo activador) o cuándo vencerá una PDT compilada correctamente (para PDT de tipo persistente). Hay dos tipos de persistencia que se muestran en la columna Regla de persistencia:

  • Se muestra Persister por: (tiempo) para las PDT que se conservan con el parámetro persist_for.
  • Activador: (nombre del grupo de datos) se muestra para las PDT 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 PDT que se conservan con un parámetro sql_trigger_value. Puedes hacer clic en el vínculo para ver la sentencia sql_trigger_value.
  • La vista materializada se muestra para las vistas materializadas, que aprovechan la funcionalidad de la base de datos para conservar tablas derivadas en ella.

Proyecto

En la columna Project, se indica el nombre del proyecto de LookML en el que se define la PDT.

Conexión

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

Modelo

La columna Model muestra el nombre del archivo de modelo en el que se incluye el archivo de vista de la PDT.

Menú de opciones

El menú de tres puntos Opciones es especialmente útil para solucionar problemas relacionados con comportamientos inesperados. 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 PDT si tienes los permisos adecuados para ver LookML.
  • Panel de actividad de PDT: Abre el panel de Actividad de PDT, que se filtra para mostrar la actividad de la PDT seleccionada durante las últimas cuatro semanas.
  • PDT Details: Abre una ventana emergente que contiene más información y estadísticas sobre una PDT 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 Supervisión y solución de problemas de PDT en la página de documentación Tablas derivadas en Looker para obtener sugerencias sobre la solución de problemas.

Modal de detalles de PDT

Haz clic en la opción PDT Details del menú de tres puntos Options para ver la ventana modal de detalles de la PDT.

La información del cuadro modal depende de la configuración del PDT. Esta es la información que puedes ver:

  • Nombre de la tabla: Es el hash de la PDT 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 PDT.
  • Nombre estable: Es el nombre de la vista estable de base de datos de la PDT en tu base de datos, si la PDT se publicó como una vista estable. Puedes publicar una PDT como vista estable en tu base de datos si agregas la instrucción publish_as_db_view: yes a la tabla derivada o si usas la instrucción materialized_view: yes para hacer que la tabla derivada sea una vista materializada.
  • Conexión: Es el nombre de la conexión en la que está habilitada la PDT.
  • Compilación anterior: Es un valor booleano que muestra si una compilación es una compilación PDT anterior o No si no lo es.
    • Tipo de tabla: para compilaciones anteriores, este campo aparece y muestra el tipo de tabla. Los valores incluyen Old Generation Table y Standin.
  • PDT incremental: Es un valor booleano que muestra Yes si una PDT es una PDT incremental o No si no lo es.
  • Estado: Indica el estado del último intento. Para compilaciones con errores, proporciona un mensaje de error de SQL y un vínculo a 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 PDT. 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 PDT que se compiló correctamente.
    • Un nodo amarillo representa una PDT que se está compilando o incrementando.
    • Un nodo rojo representa una PDT que no se pudo compilar.
    • Un nodo gris representa una PDT que aún no se compiló.
    • Un nodo blanco representa una tabla derivada temporal, que Looker no crea.
  • Compilación más reciente:
    • Latest Successful Build: La fecha y la hora de la compilación de PDT exitosa más reciente.
    • Duración de la compilación más reciente: Indica cuánto tiempo tardó la compilación de PDT más reciente (en segundos; muestra si la tabla aún no se compiló).
    • Duración promedio de compilación: Es la cantidad de tiempo que se tarda en compilar la PDT en promedio (en segundos; muestra si aún no se creó la tabla).
    • Motivo de la compilación: El motivo por el que se compiló una PDT (incepción para una compilación inicial; grupo de datos activado si la PDT persiste con un grupo de datos y trigger value change si el valor de activador de SQL de la PDT cambió).
    • Clave de incremento: Es el parámetro increment_key para las PDT que usan compilaciones incrementales.
    • Increment Offset: Es el parámetro increment_offset para las PDT 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).
    • Último SQL intentado: Es el SQL que se usó para consultar la base de datos y crear la última compilación de la tabla.
  • Regla de persistencia:
    • Tipo: 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.
    • Persister para: En el caso de las PDT de tipo Persistir, el valor de la duración de la persistencia. No se aplica a las PDT de tipo Trigger.
    • Datagroup: En el caso de los PDT de activación de grupos de datos, indica el nombre del grupo de datos.
    • Bloque de código SQL: Para las PDT de grupos de datos y SQL, el bloque de código mostrará la instrucción de SQL del activador. En el caso de los activadores de grupos de datos, este es el SQL del 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 tipo de PDT de Trigger, el valor que activó la compilación de PDT (muestra para las PDT compiladas correctamente que se conservan con un datagroup_trigger; para ver el valor de activador más reciente de un datagroup, consulta la página Datagroups en el panel Admin).
    • Last Checked: En el caso de las PDT de tipo Trigger, indica cuándo se verificó por última vez el valor del activador.
    • Expires: Es la fecha de vencimiento del PDT, si corresponde (no se aplica a los activadores de grupos de datos).

Panel de actividad de PDT

En el panel Actividad de PDT se muestra información sobre la PDT, sus recompilaciones y sus consultas.

De forma predeterminada, el panel Actividad de PDT muestra la 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 de actividad de PDT incluye mosaicos que muestran la siguiente información:

  • Un resumen de la PDT que incluye el nombre del modelo y la vista de LookML que definen la PDT, el nombre de la conexión de la base de datos que usa la PDT, la cantidad total de intentos de compilación exitosos y fallidos de la PDT, y el porcentaje de intentos de compilación totales que fallaron.
  • La fecha y hora de la recompilación completa más reciente de la PDT.
  • Si la PDT es una PDT incremental, la fecha y hora de la recompilación incremental más reciente de la PDT.
  • Si la PDT es una PDT incremental, la cantidad de recompilaciones incrementales que se produjeron desde la recompilación completa más reciente.
  • Es el tiempo promedio que se tarda en volver a compilar el PDT.
  • Una visualización que muestra todos los eventos de creación que ocurrieron recientemente, agrupados por un resumen de los tipos de acciones que los generaron.
  • Una lista de todas las recompilaciones de PDT que se realizaron durante el período del panel, incluida la fecha en que se completó cada recompilación, la cantidad de segundos que se tardó en completar cada recompilación, si las recompilaciones eran compilaciones incrementales, el activador que causó cada recompilación y la cantidad de compilaciones de PDT.
  • Una lista de todos los intentos fallidos de recompilación, incluida la fecha y hora en que comenzó la recompilación con errores, el tipo de error que causó la falla, el mensaje de error y la cantidad de fallas de creación.
  • Una lista de todos los eventos del activador de recompilación de PDT, incluido el número de ID del evento, la fecha y el tipo de evento, y los datos que se incluyen con el evento activador.
  • Una lista de todos los eventos de recompilación de PDT, incluido el número de ID, la fecha y el tipo de evento, y los datos incluidos 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.
  • La cantidad total de consultas ejecutadas en la PDT.
  • Una lista de todos los campos de PDT consultados, incluidos la vista y el modelo de LookML en los que el campo está definido, el nombre del campo, el nombre de la ejecución de Explorar que incluyó el campo y la cantidad de veces que se incluyó en una consulta.

Modelo de registro de eventos de PDT

Looker incluye un modelo prediseñado llamado system_activity que permite explorar fácilmente 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 la actividad de compilación de los PDT.

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 para cada conexión.

Puedes explorar el modelo como con cualquier otra exploración de Looker. Cuando se accede desde la página Conexiones, se filtra la exploración del registro de eventos de PDT para toda la conexión. Cuando se accede desde la página Tablas derivadas persistentes, la exploración Registro de eventos de PDT se filtra para una PDT 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 del registro de PDT para obtener más información sobre cómo ver y comprender las acciones del 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, el tiempo de vencimiento de una tabla persistente, la causa de una nueva compilación, el texto de un mensaje de error, etcétera.

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 PDT. En muchos casos, solo habrá una instancia de Looker que apunta a una base de datos, por lo que verás un solo ID. Sin embargo, si tienes una instancia de etapa de pruebas, o algo similar, es posible que veas varios IDs.
Nombre del modeloEl 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 en que ocurrió el evento (UTC).
SecuenciaEs un número de paso en la compilación de PDT.
Hash cortoEs una versión truncada del hash del SQL que se escribió para crear la tabla derivada.
Nombre de la tablaEl nombre completo de la PDT, incluidos el prefijo del tipo de tabla, un hash y el nombre de la vista.
EmpateIndica el ID de transacción.
Nombre de la vistaEs el nombre de la vista de la tabla derivada.