Configuración de administrador: Tablas derivadas persistentes

Las funciones de las 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 y solucionar problemas del comportamiento de PDT en la página Tablas derivadas persistentes, a la que pueden acceder los administradores y usuarios con los permisos adecuados 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 cómo solucionar problemas de PDT)

La página Tablas derivadas persistentes muestra solo las conexiones que tienen PDT habilitados y solo los 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 modo de desarrollo, en cuyo caso puedes usar la pestaña Desarrollo para ver la versión de desarrollo de las tablas persistentes.
• El PDT es parte de un modelo configurado correctamente.
• 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 acontecimientos PDT interno, que se describe en la sección Modelo de registro de eventos PDT en esta página.

Personalizar la tabla

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

1. Haga clic en la flecha junto a Todas las conexiones para ver los PDT de una conexión específica. El selector muestra solo las conexiones que tienen PDT habilitados y a las que tienes acceso a los datos.
2. Escriba las palabras clave en el cuadro de búsqueda para limitar la lista de PDT a 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. Haga clic en el ícono de Filtros para definir un filtro para la tabla.
4. Haz clic en el ícono de cerrar o abrir para ocultar o mostrar la sección De un vistazo.
5. Haz clic en el nombre de una columna para ordenar la tabla por esa columna. Haga clic en el nombre de la columna por segunda vez para revertir el orden.
6. Haga clic en el ícono de Seleccionar columnas para mostrar a fin de ocultar o mostrar las columnas en la tabla.
7. Haga clic en las flechas de la parte inferior de la página para navegar a la página siguiente o anterior (si la tabla es más larga que una página).
8. Utilice el selector de visualización para elegir la cantidad de resultados que se muestran en una sola página.

Filtros

Puede 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, puede filtrar por Estado de la última compilación para ver solo los PDT que están experimentando un error de compilación o puede filtrar por Modelo para limitar los PDT que se muestran a un modelo específico.

Para filtrar la página Tablas derivadas persistentes, haz lo siguiente:

1. Haga clic en el ícono de Filtros.
2. Seleccione una opción de filtro del primer selector de filtros en el menú de filtros. Las siguientes opciones están disponibles:
   • No se activó en los últimos: Filtra la página Tablas derivadas persistentes por PDT que no se activaron en una cantidad específica de horas y minutos.
   • Activado en los últimos: 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 los PDT incluidos en un modelo 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.
   • Publicado como vista estable: un valor booleano que filtra la página Tablas derivadas persistentes para los PDT y muestra Sí para los PDT que se publicaron como una vista estable, y No para los PDT que no se publicaron como una vista estable, según lo determina el valor del parámetro publish_as_db_view.
   • Duración de la última compilación más larga: Filtra la página Tablas derivadas persistentes por PDT cuyas compilaciones demoraron más de un número específico de segundos.
   • Proyecto: Filtra la página Tablas derivadas persistentes por PDT del proyecto de LookML especificado.
3. Elige el valor en el que deseas filtrar la página Tablas derivadas persistentes en el segundo selector de filtros. Para las opciones No se activó en el último o Se activó en el último, ingrese una cantidad de horas o minutos. Para la opción Last Build Duration Longer Than, ingresa la cantidad de segundos.
4. Haga clic en Agregar filtro para agregar más filtros y repita los pasos 2 y 3 para cada filtro que agregue.
   • Para borrar las selecciones de filtros y volver a comenzar en cualquier momento, haz clic en Borrar todo.
   • Para quitar filtros adicionales individuales, haga clic en Borrar arriba del filtro que desea quitar.
5. Para aplicar los criterios de filtro seleccionados a la página Tablas derivadas persistentes, haz clic en Aplicar.

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

Haz clic en la X junto a un filtro aplicado 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 PDT

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

Pestañas de producción y desarrollo

Si es 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 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 búsquedas de Explorar de los usuarios. (Si estás en el modo de producción o si no tienes permisos develop, la página Tablas derivadas persistentes no mostrará ninguna pestaña, y la página mostrará información solo para los PDT de producción).

• La pestaña Desarrollo muestra los PDT de desarrollo; estos PDT se crean durante el desarrollo y aún no se enviaron al entorno de producción:

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

SUGERENCIA: También puede ver PDT sin compilar en su 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é hace que Looker cree PDT de desarrollo y por cuánto tiempo persisten en tu base de datos.

Sección de un vistazo

La sección De un vistazo muestra un resumen visual del estado de los PDT que se muestran actualmente en la tabla. Si tiene filtros definidos para la tabla o si utilizó 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 limitará los resultados para que coincidan con lo que se muestra en la tabla PDT.

Puedes ocultar o mostrar la sección De un vistazo haciendo clic en el ícono de cerrar o 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. Haga clic en el ícono de Seleccionar columnas para mostrar a fin de 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 del PDT

La columna Nombre de PDT muestra el nombre del PDT como se define en el parámetro view del archivo de vista LookML de PDT.

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

• Compilación anterior indica que la fila muestra información sobre una compilación PDT antigua. Consulte la ventana emergente Detalles del PDT en el menú Opciones para obtener más información sobre este mensaje.
• Incremento indica que el PDT es un PDT incremental.
• Vista materializada indica que la PDT es una vista materializada de tu base de datos.

Estado del último intento

La columna Estado del último intento muestra el estado del último intento de compilación de cada PDT de la lista:

• Regenerando indica que se puede consultar el PDT y que se está compilando una tabla actualizada. Una marca de tiempo indica cuándo comenzó la compilación del PDT.
• Correcto indica que un PDT se compiló correctamente.
  
• Compilación: Indica que un PDT se está compilando y no se puede consultar hasta que se complete la compilación.
• Sin compilar indica que actualmente no se compila un PDT.
  
• Error de compilación indica que se produjo un error durante una compilación. Puede hacer clic en Error de compilación para ver la fuente del error y navegar al LookML del PDT si tiene los permisos adecuados para verlo. Consulta la sección Menú de opciones en esta página para obtener más información sobre cómo solucionar problemas de PDT en la página Tablas derivadas persistentes.
  

Último intento de

La columna Último intento indica la hora del último intento de compilación de PDT.

Última compilación exitosa

La columna Last Successful Build indica la hora de la última compilación de PDT correcta.

Duración de la última compilación

En la columna Duración de la última compilación, se muestra la cantidad de tiempo en segundos que tardó la compilación más reciente de ese PDT, y cuánto tarda en compilarse el 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 de PDT. También indica la última vez que se verificó un PDT compilado correctamente (en el caso de PDT de tipo activador o cuando este vence correctamente) (para PDT de tipo persistente). Hay dos tipos de persistencia que se muestran en la columna Regla de persistencia:

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

Proyecto

La columna Project indica el nombre del proyecto LookML en el que se define el PDT.

Conexión

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

Modelo

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

Si un archivo de vista PDT se incluye 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 modelo con diferentes conexiones, el PDT también aparecerá en otras listas de PDT de conexión.

Es importante que sea explícito cuando incluyas archivos de vista en los modelos, ya que incluir todos los archivos de vista puede saturar el esquema de la base de datos y hacer que se creen varias copias de PDT en tu base de datos o en varias bases de datos.

Menú de opciones

El menú Opciones de tres puntos 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, cuánto tiempo tardaron en compilarse, comparar el tiempo de compilación más reciente con el tiempo de compilación promedio y comprobar 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 de Actividad de PDT, que se filtra para mostrar la actividad del PDT seleccionado en las últimas cuatro semanas.
• Detalles de PDT: abre una ventana emergente que contiene más información y estadísticas de un PDT específico. Consulte la sección Modo modal de detalles de PDT de esta página para obtener más información.

Consulte el artículo del Centro de ayuda para solucionar problemas de regeneración de PDT.

Ventana modal de detalles de PDT

Haga clic en la opción Detalles del PDT del menú Opciones de tres puntos del PDT para ver la ventana modal de detalles del PDT:

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

• Nombre de la tabla: el hash del último PDT compilado correctamente
• Modelo: El nombre del archivo de modelo en el que se incluye el archivo de vista de PDT.
• Nombre estable: Nombre de la vista de base de datos estable del PDT en tu base de datos, si el PDT se publicó como tal. Puedes publicar un PDT como una vista estable en tu base de datos si agregas la declaración publish_as_db_view: yes a la tabla derivada o si usas la declaración materialized_view: yes para convertir la tabla derivada en una vista materializada.
• Conexión: Es el nombre de la conexión en la que está habilitado el PDT.
• Compilación anterior: un valor booleano que muestra Yes si una compilación es una compilación PDT antigua o No si no lo es
  • Table Type (Tipo de tabla): en las compilaciones anteriores, este campo aparece y muestra el tipo de tabla. Los valores incluyen la Tabla de generación anterior y Standin.
• PDT incremental: Booleano que muestra Sí si un PDT es un PDT incremental o No si no lo es.
• Estado: Muestra el Estado del último intento. En el caso de compilaciones con errores, 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 este PDT. Cada nodo del diagrama corresponde a una tabla derivada. El color de cada nodo corresponde al estado de la tabla derivada, de la siguiente manera:
  • Un nodo verde representa un PDT que se compiló correctamente.
  • Un nodo amarillo representa un PDT que se está compilando o incrementando.
  • Un nodo rojo representa un PDT que no se pudo compilar.
  • Un nodo gris representa un PDT que aún no se ha creado.
  • Un nodo blanco representa una tabla derivada temporal, que Looker no compila.
• Última compilación:
  • Compilación exitosa más reciente: La fecha y hora de la compilación de PDT correcta más reciente.
  • Duración más reciente de la compilación: Muestra el tiempo que tardó la compilación PDT más reciente (en segundos; muestra – si aún no se creó la tabla).
  • Duración promedio de la compilación: tiempo promedio que tarda en compilarse el PDT (en segundos; muestra – si aún no se creó la tabla).
  • Motivo de compilación: Es la razón por la que se creó un PDT (inception para una compilación inicial; datagrouptrigger si el PDT persiste con un grupo de datos; trigger value change si cambió el valor del activador de SQL de PDT).
  • Clave de incremento: El parámetro increment_key para los PDT que usan compilaciones incrementales
  • Incremento de desplazamiento: El parámetro increment_offset para los PDT que usan compilaciones incrementales.
  • Incrementar las filas agregadas o quitadas de la compilación: La cantidad de filas que se agregaron a la tabla o se quitaron de ella cuando se incrementó por última vez (muestra – si no se agregaron ni quitaron filas cuando la estrategia de persistencia de la tabla activó un incremento en la última vez).
  • Último intento de 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: El tipo de persistencia que usa la tabla. Consulta la sección Regla de persistencia de esta página para conocer los posibles valores.
  • Persistir para: En el tipo PD persistente, el valor de duración de persistencia. No aplicable para PDT de tipo activador.
  • Datagroup: para los PDT del activador de grupo de datos, proporciona el nombre del grupo de datos.
  • Bloqueo de código SQL: Para los PDT de grupos de datos y activadores de SQL, el bloque de código mostrará la instrucción de SQL del activador. Para los activadores de grupos de datos, este es el SQL del parámetro sql_trigger del grupo de datos. Para los activadores de SQL, este es el SQL del parámetro sql_trigger_value.
  • Valor del activador: En el caso de los PDT de tipo activador, es el valor que activó la compilación del PDT (muestra – para los PDT compilados correctamente que persisten con un datagroup_trigger; a fin de ver el valor activador más reciente de un grupo de datos, consulta la página Grupos de datos en el panel Administrador).
  • Última verificación: En el caso del activador, escriba PDT, cuando se verificó el valor del activador por última vez.
  • Vencimiento: Cuando venza el PDT, si corresponde (no aplicable a activadores de grupos de datos).

Panel de actividad de PDT

El panel Actividad de PDT muestra información sobre el PDT, sus recompilaciones y sus consultas:

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

• Un resumen del PDT que incluye el nombre del modelo de LookML y la vista que define el PDT, el nombre de la conexión de la base de datos que usa el PDT, la cantidad total de intentos de compilación fallidos y fallidos del PDT y el porcentaje de intentos de compilación totales que fallaron.
• La fecha y hora de la recompilación completa más reciente del PDT.
• Si el PDT es un PDT incremental, indica la fecha y hora de la recompilación incremental más reciente.
• Si el PDT es un PDT incremental, es la cantidad de recompilaciones incrementales que se produjeron desde la recompilación completa más reciente.
• El tiempo promedio que se tomó para reconstruir 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 generaron los eventos.
• Una lista de todas las recompilaciones de PDT que se produjeron durante el período del panel, incluida la fecha en la que se completó cada compilación, la cantidad de segundos que se llevó a cabo en cada compilación, si las nuevas compilaciones fueron incrementales, el activador que generó cada una y la cantidad de compilaciones PDT
• Una lista de todos los intentos de recompilación fallidos, incluida la fecha y la 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 del evento, el tipo de evento y los datos incluidos en él.
• Una lista de todos los eventos de recompilación de PDT, incluido el número de ID del evento, la fecha del evento, el tipo de evento y los datos incluidos en él.
• La cantidad de consultas que consultaron directamente un campo, agrupadas por la fuente de la consulta y el entorno de ejecución promedio para cada fuente de consulta.
• La cantidad total de consultas que se ejecutan en el PDT.
• Una lista de todos los campos 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 incluyó el campo y la cantidad de veces que se incluyó en una consulta.

Modelo de registro de acontecimientos de PDT

Looker incluye un modelo creado previamente llamado system_activity que permite explorar con facilidad el registro de acontecimientos de PDT, que es una tabla en un esquema temporal de conexión de base de datos que realiza un seguimiento del activador y la actividad de compilación de PDT. Puede acceder al modelo con los vínculos Eventos de compilación recientes y Eventos de activador recientes en el menú de tres puntos Opciones de la página Tablas derivadas persistentes o desde la página Conexiones del panel Administrador de Looker. Para acceder al registro de acontecimientos de PDT desde la página Conexiones, seleccione la opción Mostrar registro de acontecimientos de PDT del menú desplegable de ajustes que se encuentra en el extremo derecho de cada conexión:

Puedes explorar el modelo como con cualquier otra exploración de Looker. Cuando se accede desde la página Conexiones, la exploración del Registro de acontecimientos de ADT se filtra por toda la conexión. Cuando se accede desde la página Tablas derivadas persistentes, la exploración del Registro de eventos de PDT se filtra por un PDT específico.

Esta es una guía breve de los campos disponibles:

Campo	Descripción
Acción	Describe la acción que se produjo; esto puede incluir la actividad de regeneración, eliminación, creación y 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 recompilación, el texto de un mensaje de error, etcétera. Consulta la página de documentación Comprende 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	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 orientada a una base de datos, por lo que solo verás un ID. Sin embargo, si tienes una instancia de etapa de pruebas o algo de esa naturaleza, es posible que veas varios ID.
Nombre del modelo	El nombre del modelo a través del cual se generó la tabla.
Fecha de aparición	Fecha y hora en que se produjo el evento.
Fecha de visualización de Utc	Fecha y hora en que ocurrió el evento en UTC.
Secuencia	Un número de paso en la compilación PDT.
Hash corto	Una versión truncada del hash del SQL que se escribió para crear la tabla derivada.
Table Name	El nombre completo del PDT, incluidos el prefijo de tipo de tabla, un hash y el nombre de la vista.
Tiro	El ID de transacción.
Nombre de la vista	El nombre de la vista de la tabla derivada.