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 hacer un seguimiento del comportamiento de las PDT y solucionar problemas relacionados en la página Tablas derivadas persistentes, a la que los administradores y los 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 Tablas derivadas en Looker para obtener información sobre la solución de problemas relacionados con las PDT).

Nota: Para acceder a todas las páginas de administración de Looker, debes tener el rol de administrador. Si tienes un permiso que habilita solo partes del panel Administrador, como manage_schedules o manage_themes, pero no tienes el rol de administrador, es posible que Looker no muestre las páginas que se describen en este artículo en el panel Administrador. Además, el permiso see_admin otorga permiso de solo lectura a la mayoría (pero no a todas) las páginas de Administrador. Consulta la descripción de see_admin para obtener más información.

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 los 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 aquellas 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 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 ocultar o mostrar 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é 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 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 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 las PDT que se activaron en una cantidad especificada 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.
   • Publicadas 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 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 PDT cuyas compilaciones tardaron más que una cantidad especificada de segundos.
   • Proyecto: Filtra la página Tablas derivadas persistentes por PDT 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 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 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 los 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 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 PDT de producción).

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

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

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

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 PDT 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 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 restringir la tabla a una conexión específica, la sección De un vistazo limitará 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 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 Nombre de PDT 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. Consulta la ventana emergente Detalles de la PDT en el menú Opciones para obtener más información sobre este mensaje.
• 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 de la lista:

• Regenerar 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.
• Compilando indica que se está compilando una PDT y que 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 en esta página para obtener más información sobre la solución de problemas de las PDT en la página Tablas derivadas persistentes.

Último intento

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

Ú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

La columna Last Build Duration muestra la cantidad de tiempo en segundos que tardó la compilación más reciente de esa PDT y cuánto tiempo tarda en compilarse la PDT en promedio en segundos.

Regla de persistencia

La columna Persistence Rule muestra el tipo de persistencia aplicada a un PDT, como se define en el archivo de vista del 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 Persistence Rule:

• Persistir durante: (tiempo) se muestra para los PDT que se conservan con el parámetro persist_for.
• Activador: (nombre del grupo de datos) se muestra para los 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 los PDT 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 el 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.

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

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

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 el PDT 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 del PDT seleccionado durante las últimas cuatro semanas.
• Detalles de la PDT: Abre una ventana emergente con más información y estadísticas de 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 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 PDT para ver el cuadro 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 podrías 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 del PDT.
• Nombre estable: Es el nombre de la vista de base de datos estable del PDT en tu base de datos, si el PDT se publicó como una vista estable. Para publicar un PDT como vista estable en tu base de datos, agrega la sentencia publish_as_db_view: yes a la tabla derivada o usa la sentencia 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 Sí si una compilación es una compilación PDT anterior o No si no lo es.
  • Tipo de tabla: En el caso de 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 Sí si una PDT 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 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 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 de PDT más reciente que se realizó correctamente.
  • 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: Indica cuánto tiempo tarda en compilarse el PDT 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 PDT (inicio para una compilación inicial; activado por un grupo de datos si la PDT se conserva con un grupo de datos; cambio de valor del activador si cambió el valor del activador de SQL de la PDT).
  • 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:
  • 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 PDT de tipo Persist, el valor de 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: En el caso de los PDT de grupo de datos y activador de 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 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 los PDT de tipo Trigger, es el valor que activó la compilación de PDT (se muestra – para los PDT compilados correctamente que se conservan con un datagroup_trigger. Para ver el valor del activador más reciente de un datagroup, consulta la página Datagroups en el panel Administrador).
  • Última verificación: 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 PDT Activity, se muestra información sobre el PDT, sus recompilaciones 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 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.
• Es la fecha y hora de la compilación completa más reciente del PDT.
• Si el PDT es incremental, la fecha y hora de la compilación incremental más reciente del PDT
• Si el PDT es incremental, indica 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 compilar el PDT.
• 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.
• Una lista de todas las recompilaciones de PDT 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 PDT.
• 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.
• Una lista de todos los eventos del activador de reconstrucción de PDT, incluidos el número de ID del evento, la fecha del evento, el tipo de evento y los datos incluidos con el evento del activador
• Una lista de todos los eventos de reconstrucción de PDT, incluidos el número de ID del evento, la fecha del evento, el tipo de evento y los datos incluidos con el evento de reconstrucció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 el PDT.
• Es una lista de todos los campos de PDT 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.

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 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 PDT específica.

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

Campo	Descripción
Acción	Describe 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ón	Proporciona 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, 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ón	Es 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ó el PDT 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 modelo	Es el nombre del modelo a través del cual se generó la tabla.
Fecha de ocurrencia	La fecha y hora en que ocurrió el evento.
Fecha de visualización de UTC de ocurrencia	La fecha y hora en que ocurrió el evento (UTC).
Secuencia	Es un número de paso en la compilación de PDT.
Hash corto	Es una versión truncada del hash del SQL que se escribió para crear la tabla derivada.
Nombre de la tabla	Es el nombre completo del PDT, incluido el prefijo de tipo de tabla, un hash y el nombre de la vista.
Tid	El ID de la transacción.
Nombre de la vista	Es el nombre de la vista de la tabla derivada.