Configuración del administrador: tablas derivadas persistentes

Las funciones de tablas derivadas persistentes (PDT) de Looker te permiten realizar análisis complejos en Looker. 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 las PDT habilitadas y solo las PDT que cumplen con los siguientes criterios:

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

La información de esta página se basa en un registro de eventos de PDT interno, descrito en la sección Modelo de 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 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 conexiones que tienen habilitadas las 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á las 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 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 una segunda vez para invertir el orden.
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 extensa que una sola página, puedes hacer clic en las flechas que se encuentran en el centro de la parte inferior de la página para navegar a la página siguiente o anterior.

Filtros

Puedes usar el ícono de 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 las PDT que experimentan un error de compilación o puedes filtrar por Model para limitar las 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 PDT que no se activaron en una cantidad específica 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 model especificado.
   • Regla de persistencia: Filtra la página Tablas derivadas persistentes por tipo de persistencia de 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 Sí 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 Activada en las últimas, ingresa una cantidad de horas o minutos. En la opción La duración de la última compilación es 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 correspondiente al 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 quitar 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. Estas son las PDT que se implementaron para producción en tu instancia y proporcionan los datos para las consultas de Explorar de los 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. Las 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 Desarrollo puede ayudarte a determinar qué PDT de desarrollo creó Looker y si se compiló.

Sugerencia: También puedes ver las PDT no compiladas en tu proyecto con el IDE de Looker.

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/abrir en la parte superior de la sección.

Columnas de la tabla

En las siguientes secciones, se describen las columnas de la tabla en 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.

En la columna Nombre de la PDT, se 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 de 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.
• La vista materializada indica que la 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 compilar la PDT.
• Success indica que una PDT se compiló correctamente.
• Building indica que se está compilando una PDT y no se puede consultar hasta que se complete la compilación.
• Not Build indica que no se está compilando una PDT actualmente.
• Build Error indica que se produjo un error durante la compilación. Puedes hacer clic en Error de compilación para ver la fuente del error y navegar a LookML de la 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

En la columna Last Successful Build, se indica la hora de la última compilación de PDT exitosa.

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, según se define en el archivo de vista de la PDT. También indica la última vez que se verificó una PDT compilada correctamente (para las PDT de tipo de activador) o cuándo una PDT compilada correctamente debe vencer (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 conexión, aparecerá la columna Conexión y mostrará el nombre de la conexión en la que se habilitó la PDT.

Modelo

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

Nota: Si se incluye un archivo de vista de PDT en varios archivos de modelo que comparten la misma conexión, varios modelos aparecerán en la columna Modelo. Si se incluye un archivo de vista de PDT en varios archivos de modelo con diferentes conexiones, la PDT también aparecerá en otras listas de PDT de conexiones.

Es importante ser explícito cuando se incluyen archivos de vista en los modelos, ya que incluir todos los archivos de vistas puede desordenar el esquema de la base de datos y generar que se compilen varias copias de PDT en tu base de datos o en múltiples bases de datos.

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 comprobar cuándo se compilaron las tablas por última vez, comprobar cuánto tiempo tardaron en compilarse, comparar el tiempo de compilación más reciente con el tiempo 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 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 de la ventana modal depende de la configuración de la PDT. Esta es la información que puedes ver:

• Nombre de la tabla: El hash de la PDT compilada correctamente más reciente.
• 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 usas la instrucción materialized_view: yes para convertir la tabla derivada en una vista materializada.
• Connection: Es el nombre de la conexión en la que está habilitada la PDT.
• Compilación anterior: Es un valor booleano que muestra Sí si una compilación es una compilación de PDT antigua 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 Show Dependency Graph para mostrar un diagrama de relación 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, de la siguiente manera:
  • 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.
• Última compilación:
  • 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 aún no se compiló la tabla).
  • 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 compiló 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ó).
  • Increment Key: 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.
  • Incremento de las filas agregadas o quitadas de la compilación: Es la cantidad de filas que se agregaron o quitaron de la tabla cuando esta se incrementó por última vez (muestra – si no se agregaron o quitaron filas cuando la estrategia de persistencia de la tabla activó un incremento por última vez).
  • Last Attempted SQL: El SQL que se usó para consultar la base de datos a fin de 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 Regla de persistencia de 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.
  • Grupo de datos: Para las PDT de activadores de grupos de datos, proporciona 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 del 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 grupo de datos, consulta la página Datagroups en el panel Admin).
  • Last Checked (Última verificación): Para las PDT de tipo Trigger, cuando se verificó por última vez el valor del activador.
  • Vence: Cuando vence la PDT, si corresponde (no aplicable 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 información de la actividad de las últimas cuatro semanas. Puedes cambiar el período que se muestra con la barra de filtros 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 de LookML y la vista que define 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 total de intentos de compilación fallidos.
• 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.
• El tiempo promedio que se tarda en volver a compilar la 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.
• La cantidad de consultas que consultaron directamente un campo, agrupadas por la fuente de la consulta y el entorno 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 se define el campo, 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 compilado previamente llamado system_activity que permite explorar con facilidad el registro de eventos de PDT, que es una tabla en el esquema temporal de una conexión de base de datos que hace un seguimiento del activador y la actividad de compilación de las 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, se filtra la exploración del registro de eventos de PDT para una PDT específica.

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

Campo	Descripción
Acción	Describe la acción que ocurrió. Esto puede incluir la regeneración, la caída, 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ón	Proporciona 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 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.
Conexión	El nombre de la conexión en la que existe la tabla derivada.
Hash	Cada tabla derivada contiene un hash del SQL que se escribió para crearla.
ID	El 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 modelo	El nombre del modelo a través del cual se generó la tabla.
Fecha de ocurrencia	Fecha y hora en que ocurrió el evento.
Ocurre la fecha de visualización de Utc	Es la fecha y hora en que ocurrió el evento, en formato UTC.
Secuencia	Un número de paso en la compilación de PDT.
Hash corto	Una versión truncada del hash del SQL que se escribió para crear la tabla derivada.
Nombre de la tabla	El nombre completo de la PDT, incluidos el prefijo del tipo de tabla, un hash y el nombre de la vista.
Empate	Indica el ID de transacción.
Nombre de la vista	Es el nombre de la vista de la tabla derivada.