Ten en cuenta que estás viendo la documentación de Looker. Para obtener la documentación de Looker Studio, visita https://support.google.com/looker-studio.

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 hacer un seguimiento del comportamiento de las PDT y solucionar problemas relacionados con el comportamiento de las PDT en la página Tablas derivadas persistentes, a la que pueden acceder los administradores y los 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 de 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 Development Mode, en cuyo 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 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 eventos de PDT interno, que se describe en la sección Modelo de registro de eventos de PDT en esta página.

Personaliza la tabla

De forma predeterminada, en la página Tablas derivadas persistentes, se muestra un máximo de 25 PDT y se cargan 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:

Haz clic en la flecha junto a All Connections para ver las PDT de una conexión específica únicamente. El selector solo muestra las conexiones que tienen PDT habilitadas y a las que tienes acceso a los datos.
Escribe palabras clave en el cuadro de búsqueda para limitar la lista de 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 la búsqueda.
Haz clic en el ícono de Filtros para definir un filtro para la tabla.
Haz clic en el ícono para cerrar o abrir para ocultar o mostrar la sección De un vistazo.
Haz clic en el nombre de una columna para ordenar la tabla por esa columna. Haz clic en el nombre de la columna por segunda vez para revertir el orden.
Haz clic en el ícono Seleccionar columnas para mostrar para ocultar o mostrar columnas en la tabla.
Usa el selector de pantalla 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 de Filtros junto a la barra de búsqueda para elegir qué PDT se mostrarán 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, haz lo siguiente:

Haz clic en el ícono Filtros.
Selecciona una opción de filtro del primer selector de filtros del menú de filtros. Están disponibles las siguientes opciones:
- No activadas en la última vez: Filtra la página Tablas derivadas persistentes por las PDT que no se activaron en una cantidad específica de horas y minutos.
- Activada en la última vez: Filtra la página Tablas derivadas persistentes por las 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.
- Publicado como vista estable: Es un valor booleano que filtra la página Tablas derivadas persistentes en busca de PDT y muestra Sí para las PDT que se publicaron como una vista estable y No para las PDT que no se publicaron como una vista estable, según lo determinado por el valor del parámetro publish_as_db_view.
- Duración de la última compilación mayor que: Filtra la página Tablas derivadas persistentes por las PDT cuyas compilaciones tardaron más de un número especificado de segundos.
- Proyecto: Filtra la página Tablas derivadas persistentes por las PDT del proyecto de LookML especificado.
Elige el valor en el que deseas filtrar la página Tablas derivadas persistentes en el segundo selector de filtro. Para las opciones No activada en el último momento o Activado en la última vez, ingresa una cantidad de horas o minutos. Para la opción Duración de la última compilación más larga que, ingresa la cantidad de segundos.
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 empezar en cualquier momento, haz clic en Borrar todo.
- Para quitar cualquier filtro adicional individual, haz clic en Borrar arriba del filtro que quieres quitar.
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 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 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 en producción en tu instancia. Estas son las PDT que proporcionan los datos para las consultas de Explorar de tus usuarios. (Si estás en 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 las PDT de producción).
En la pestaña Desarrollo, se muestran las PDT de desarrollo. Aún no se enviaron las PDT de desarrollo 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 de la PDT o la forma en que se consulta la PDT. Estos cambios solicitan a Looker que cree la PDT de desarrollo, pero no la compila, a menos que se consulte la PDT después de realizar los cambios. La pestaña Desarrollo puede ayudarte a determinar qué PDT de desarrollo creó Looker y si ya se compilaron.

Consulta la página de documentación de las Tablas derivadas de Looker para obtener más información sobre qué solicita a Looker crear PDT de desarrollo y por 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 si usaste la flecha junto a All Connections 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.

Puedes ocultar o mostrar la sección De un vistazo haciendo clic en el ícono para cerrar o abrir, ubicado 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 Personaliza la tabla de esta página.

Nombre de la PDT

En la columna Nombre de la PDT, 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 PDT Name, se muestra esta información adicional debajo del nombre de la PDT, cuando corresponda:

Old Build 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 la PDT es una vista materializada de tu base de datos.

Estado del último intento

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

Regenerando indica que se puede consultar la PDT y que hay una tabla actualizada que se está compilando en ese momento. Una marca de tiempo indica cuándo comenzó la compilación la PDT.
Success indica que una PDT se compiló de forma correcta.
Compilación indica que una PDT se está compilando y no se puede consultar hasta que se complete la compilación.
Sin compilar indica que una PDT no se ha compilado actualmente.
Build Error indica que se produjo un error durante una compilación. Puedes hacer clic en Build Error 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 del 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

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

Última compilación correcta

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

Duración de la última compilación

En la columna Last Build Duration, se muestra la cantidad de tiempo en segundos que tardó en compilarse la PDT más reciente y cuánto tiempo, en promedio, en segundos.

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 las PDT de tipo de activador) o cuándo vencerá una PDT compilada de forma correcta (para las PDT de tipo persistente). Hay dos tipos de persistencia que se muestran en la columna Regla de persistencia:

Se muestra Conservar durante: (tiempo) para las PDT que persisten con el parámetro persist_for.
Activador: (datagroup name) se muestra para las 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 las PDT que persisten 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 en las vistas materializadas, que aprovechan la funcionalidad de tu base de datos para conservar las tablas derivadas en ella.

Proyecto

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

Connection

Si se elige All Connections en la selección de conexión, aparecerá la columna Connection, que mostrará el nombre de la conexión en la que está habilitada la PDT.

Entrega

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

Si se incluye un archivo de vista de PDT en varios archivos de modelo que comparten la misma conexión, aparecerán varios modelos 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 conexión.

Es importante ser explícito cuando incluyas archivos de vista en modelos, ya que incluir todos los archivos de vista puede desordenar el esquema de tu base de datos y hacer 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 particularmente útil para solucionar problemas relacionados con comportamientos inesperados. Las opciones que presenta te permiten verificar cuándo se compilaron las tablas por última vez, comprobar cuánto tardaron en compilarse, comparar el tiempo de compilación más reciente con el tiempo promedio de compilación 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 la 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 de la PDT seleccionada en 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 la PDT en esta página para obtener más información.

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

Modal de detalles de la PDT

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

La información en la ventana modal depende de la configuración de la PDT. Esta es la información que puede aparecer:

Nombre de la tabla: El hash de la PDT compilada de forma correcta más reciente.
Modelo: Es el nombre del archivo de modelo en el que se incluye el archivo de vista de la PDT.
Stable Name: Es el nombre de la vista estable de la 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 una vista estable en tu base de datos si agregas la sentencia publish_as_db_view: yes a la tabla derivada o la instrucción materialized_view: yes para hacer que la tabla derivada sea una vista materializada.
Connection: Es el nombre de la conexión en la que está habilitada la PDT.
Compilación anterior: Booleano que muestra Sí si una compilación es una compilación PDT antigua o No si no lo es.
- Table Type: Para compilaciones anteriores, aparece este campo y muestra el tipo de tabla. Los valores incluyen Tabla de generación anterior 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 (Status): Muestra el estado del último intento (Last Intent Status). En el caso de las 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.
Dependencies: 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 aumentando actualmente.
- 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 compila.
Última compilación:
- Última compilación correcta: Fecha y hora de la compilación exitosa de PDT más reciente.
- Última duración de la compilación (Latest Build Duration): Indica cuánto tiempo tardó la compilación de PDT más reciente (en segundos; muestra – si la tabla aún no se ha compilado).
- Duración promedio de compilación: Es el tiempo que se tarda en compilar la PDT en promedio (en segundos; muestra – si la tabla aún no se creó).
- Motivo de la compilación: El motivo por el que se compiló una PDT (inception para una compilación inicial; datagroup activate si la PDT persiste con un grupo de datos; trigger value change si cambió el valor del activador de SQL de la PDT).
- 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 filas agregadas o quitadas: Cantidad de filas que se agregaron o quitaron de la tabla la última vez que esta se aumentó (muestra – si no se agregaron ni quitaron filas cuando la estrategia de persistencia de la tabla activó un incremento por última vez).
- Último intento de SQL: Es 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 Columna Regla de persistencia de esta página para conocer los valores posibles.
- Conservar por: Para las PDT de tipo Conservar, el valor de duración de la persistencia. No se aplica a las PDT de tipo Activador.
- Datagroup: Para las PDT de los activadores de grupos de datos, indica el nombre del grupo de datos.
- Bloque de código SQL: Para las PDT de grupos de datos y activadores 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 los activadores de SQL, este es el SQL del parámetro sql_trigger_value.
- Valor del activador: Para las PDT de tipo Activador, es el valor que activó la compilación de PDT (muestra – para las PDT compiladas correctamente que persisten con un datagroup_trigger). Si quieres ver el valor de activador más reciente de un grupo de datos, consulta la página Grupos de datos en el panel Administrador.
- Last Checked: Para las PDT de tipo Trigger, cuando el valor del activador se verificó por última vez.
- Vence: Cuando vence la PDT, si corresponde (no aplicable para activadores de grupos de datos).

Panel de actividad de PDT

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

De forma predeterminada, el panel PDT Activity muestra información sobre la actividad de las últimas cuatro semanas. Puedes cambiar el período que se muestra con la barra de filtros ubicada en la parte superior del panel. El panel de PDT Activity incluye mosaicos en los que se muestra la siguiente información:

Un resumen de la PDT en el que se 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 total de intentos de compilación que fallaron.
La fecha y hora de la recompilación completa más reciente de la PDT.
Si la PDT es incremental, se trata de la fecha y hora de la recompilación incremental más reciente.
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 lleva volver a compilar la 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 recompilación, la cantidad de segundos que se tardaron en completar cada recompilación, si estas fueron compilaciones incrementales, el activador que provocó cada recompilación y la cantidad de compilaciones de PDT.
Una lista de todos los intentos de recompilación con errores, incluida la fecha y la hora en que comenzó la compilación con errores, el tipo de error que causó la falla, el mensaje de error y la cantidad de errores 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 con el evento activador.
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 que se incluyen 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 para cada fuente de consulta.
La cantidad total de consultas que se ejecutan 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 la exploración que incluyó el campo y la cantidad de veces que se incluyó el campo en una consulta.

Modelo de registro de eventos de PDT

Looker incluye un modelo creado previamente llamado system_activity que permite explorar con facilidad el registro de eventos de PDT, que es una tabla en un esquema temporal de una conexión de base de datos que hace un seguimiento de la actividad de activación y compilación de las PDT. Puedes acceder al modelo con los vínculos Recent Build Events y Recent Trigger Events en el menú de tres puntos Options de la página Persistent derivad Tables, o desde la página Connections en el panel Admin 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 menú de ajustes ubicado 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 eventos de PDT se filtra para 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 para una PDT específica.

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

Campo	Descripción
Acción	Describe la acción que se produjo; esto puede incluir la actividad de regeneración, caída, creación y 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, incluidos el activador que se utiliza, el valor de un activador, el tiempo 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 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.
Connection	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 solo verás un 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.
Fecha de aparición en Utc	Fecha y hora en que se produjo el evento, expresada en UTC.
Secuencia	Un número de paso en la compilación de PDT.
Hash corto	Una versión truncada del hash de SQL que se escribió para crear la tabla derivada.
Nombre de la tabla	El nombre completo de la PDT, incluido el prefijo del tipo de tabla, un hash y el nombre de la vista.
Tid	Indica el ID de transacción.
Nombre de la vista	El nombre de la vista de la tabla derivada.