Configuración del administrador: Tablas derivadas persistentes

En la página de administración de Tablas derivadas persistentes de Looker, se muestra el estado de las tablas persistentes de la instancia de Looker (que incluyen las tablas derivadas persistentes y las tablas agregadas).

En la página de administrador de Tablas derivadas persistentes, se muestran varias funciones de administrador que pueden ayudar a realizar un seguimiento del comportamiento persistente de la tabla y solucionar problemas relacionados. Consulta la página de documentación de Tablas derivadas en Looker para obtener información sobre la solución de problemas relacionados con las tablas persistentes.

Los administradores y usuarios de Looker con el permiso see_pdts pueden acceder a la página Tablas derivadas persistentes.

Para abrir la página Tablas derivadas persistentes, sigue estos pasos:

  1. Haz clic en el ícono de Menú principal de Looker y selecciona Administrador, si no se muestra el menú Administrador. Si estás en la sección Explorar o Desarrollar del Menú principal de Looker, es posible que debas hacer clic en la flecha hacia atrás para ver el menú Administrador.
  2. En el menú Administrador, selecciona Tablas derivadas persistentes.

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

  • La tabla persistente 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 tabla persistente es parte de un modelo que está configurado de forma correcta.
  • La tabla persistente es 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, descrito en la sección Exploración de registros 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 tablas persistentes en la página y las carga para todas las conexiones a 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. Para ver las tablas persistentes solo de una conexión específica, haz clic en la flecha junto a Todas las conexiones y, luego, selecciona el nombre de la conexión específica. El selector solo muestra conexiones que están habilitadas para PDT y para las que tienes acceso a datos.
  2. Ingresa palabras clave en el cuadro de búsqueda para limitar la lista de tablas persistentes a aquellas cuyos nombres incluyan la palabra clave. La tabla mostrará las tablas persistentes que tienen 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 mostrarán 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é tablas persistentes se muestran en la página Tablas derivadas persistentes. Por ejemplo, puedes filtrar por Last Build Status para ver solo las tablas persistentes que experimentan un error de compilación, o puedes filtrar por Model para limitar las tablas persistentes 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 los últimos: Filtra la página Tablas derivadas persistentes por tablas persistentes 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 tablas persistentes que se activaron en una cantidad específica de horas y minutos.
    • Modelo: Filtra la página Tablas derivadas persistentes para las tablas persistentes que se incluyen en un modelo especificado.
    • Regla de persistencia: Filtra la página Tablas derivadas persistentes por tipo de persistencia.
    • Estado del último intento: Filtra la página Tablas derivadas persistentes por el estado de una tabla persistente especificada.
    • Publicado como vista estable: un valor booleano que filtra la página Tablas derivadas persistentes para las tablas persistentes y muestra para las tablas persistentes que se publicaron como una vista estable y No para las tablas persistentes que no se publicaron como una vista estable, según lo determinado por su valor de parámetro publish_as_db_view.
    • Duración de la última compilación mayor que: Filtra la página Tablas derivadas persistentes por tablas persistentes cuyas compilaciones tardaron más de una cantidad específica de segundos.
    • Proyecto: Filtra la página Tablas derivadas persistentes por tablas persistentes 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 filtro. 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 tablas derivadas persistentes

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

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

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

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 tablas persistentes de desarrollo y por cuánto tiempo se conservan estas tablas 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 tablas persistentes que se muestran en ella. Si definiste filtros para la tabla o si 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 la tabla persistente.

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 tabla persistente definida en el parámetro view del archivo de vista de LookML de la tabla persistente.

En la columna PDT Name, se muestra esta información adicional debajo del nombre de la tabla persistente, cuando corresponde:

  • Compilación anterior indica que la fila muestra información sobre una compilación de tabla persistente anterior. Consulta el diálogo PDT Details en el menú Options para obtener más información sobre este mensaje.
  • Incremental indica que la tabla persistente es una PDT incremental.
  • Vista materializada indica que la tabla persistente 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 las tablas persistentes de la lista:

  • Regenerating indica que se puede consultar la tabla persistente y que se está compilando una tabla actualizada. Una marca de tiempo indica cuándo comenzó a compilar la tabla persistente.
  • Success indica que una tabla persistente se compiló correctamente.
  • Compilación indica que se está compilando una tabla persistente y no se puede realizar consultas hasta que se complete la compilación.
  • Not Build indica que no se compiló una tabla persistente.
  • 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 tabla persistente 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 tablas persistentes en la página Tablas derivadas persistentes.

Último intento

En la columna Last Attempted At, se indica la hora del último intento de compilación de tabla persistente.

Última compilación correcta

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

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 le tomó la compilación más reciente de esa tabla persistente y cuánto tiempo, en promedio, se tardó, en segundos, en compilar la tabla persistente.

Regla de persistencia

En la columna Regla de persistencia, se muestra el tipo de persistencia que se aplica a una tabla persistente, como se indica en la definición de LookML de la tabla persistente. También indica la última vez que se verificó una tabla persistente compilada correctamente (para las tablas persistentes de tipo de activador) o cuándo vence la fecha de vencimiento de una tabla persistente compilada correctamente (para las tablas persistentes de tipo persistente). Hay dos tipos de persistencia que se muestran en la columna Regla de persistencia:

  • Se muestra Persister por: (tiempo) para las tablas persistentes que se conservan con el parámetro persist_for.
  • Activador: (nombre del grupo de datos) se muestra para las tablas persistentes 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 tablas persistentes 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 Proyecto, se indica el nombre del proyecto de LookML en el que se define la tabla persistente.

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 está habilitada la tabla persistente.

Modelo

En la columna Modelo, se muestra el nombre del archivo del modelo asociado con la tabla persistente. Para una PDT, por lo general, este es el archivo de modelo que incluye el archivo de vista en el que se define la PDT. En el caso de una tabla conjunta, este suele ser el archivo de modelo en el que se define la tabla conjunta.

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 tabla persistente si tienes los permisos adecuados para ver LookML.
  • Panel de actividad de PDT: Abre el panel de PDT Activity, que se filtra para mostrar la actividad de la tabla persistente seleccionada durante las últimas cuatro semanas.
  • PDT Details: Abre un diálogo que contiene más información y estadísticas de una tabla persistente 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 de la tabla persistente para ver la ventana modal de detalles de PDT.

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

  • Nombre de la tabla: El hash de la última tabla persistente compilada correctamente.
  • Modelo: Es el nombre del archivo de modelo en el que se incluye el archivo de vista de la tabla persistente.
  • Nombre estable: Es el nombre de la vista de base de datos estable de la tabla persistente en tu base de datos, si esa tabla se publicó como una vista estable. Puedes publicar una tabla persistente como una vista estable en tu base de datos si agregas la sentencia publish_as_db_view: yes a la PDT o a la tabla conjunta, o bien usa la sentencia 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 tabla persistente.
  • Compilación anterior: Es un valor booleano que muestra si una compilación es una compilación de tabla persistente anterior o No si no lo es.
    • Tipo de tabla: para compilaciones anteriores, este campo aparece y muestra el tipo de tabla. Los valores incluyen Old Generation Table y Standin.
  • PDT incremental: Es un valor booleano que muestra Yes si una tabla persistente es una PDT incremental o No si no lo es.
  • Estado: Indica el estado del último intento. Para compilaciones con errores, proporciona un mensaje de error de SQL y un vínculo a LookML del modelo si el usuario tiene los permisos adecuados para ver LookML.
  • Dependencias: Haz clic en el botón Mostrar gráfico de dependencias para mostrar un diagrama de relación de todas las tablas derivadas de las que depende esta tabla persistente. 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 tabla persistente que se compiló correctamente.
    • Un nodo amarillo representa una tabla persistente que se está compilando o incrementando.
    • Un nodo rojo representa una tabla persistente que no se pudo compilar.
    • Un nodo gris representa una tabla persistente 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 exitosa de la tabla persistente más reciente.
    • Duración de la compilación más reciente: Indica cuánto tiempo tardó la compilación de la tabla persistente más reciente (en segundos; se muestra si aún no se creó la tabla).
    • Duración promedio de compilación: Es la cantidad de tiempo que se tarda en compilar la tabla persistente en promedio (en segundos; se muestra si la tabla todavía no se creó).
    • Motivo de la compilación: El motivo por el que se compiló una tabla persistente (desde el origen para una compilación inicial; grupo de datos activado si la tabla persistente se mantiene con un grupo de datos; activa el cambio en el valor si cambió el valor del activador de SQL de la tabla persistente).
    • Increment Key: Es el parámetro increment_key para las tablas persistentes que usan compilaciones incrementales.
    • Increment Offset: Es el parámetro increment_offset para tablas persistentes 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 por: En las tablas persistentes de tipo Persister, es el valor de la duración de la persistencia. No aplicable a las tablas persistentes de tipo Trigger.
    • Grupo de datos: Para las tablas persistentes del activador de grupos de datos, proporciona el nombre del grupo de datos.
    • Bloque de código SQL: En el caso de las tablas persistentes 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 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 de activación: para las tablas persistentes de tipo Activador, el valor que activó la creación de la tabla persistente (muestra para las tablas persistentes creadas correctamente que se conservan con un datagroup_trigger; para ver el valor de activación más reciente para un grupo de datos, consulte la página Grupos de datos en el panel Administración).
    • Last Checked (Última verificación): Para las tablas persistentes de tipo Trigger, cuando se verificó el valor del activador por última vez.
    • Vence: Cuando vence la tabla persistente, si corresponde (no aplicable a los activadores de grupos de datos).

Panel de actividad de PDT

En el panel PDT Activity, se muestra información sobre la tabla persistente, 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 tabla persistente que incluye el nombre del modelo de LookML y la vista que definen la tabla persistente, el nombre de la conexión de la base de datos que usa la tabla persistente, la cantidad total de intentos de compilación exitosos y fallidos de la tabla persistente y el porcentaje total de intentos de compilación fallidos.
  • La fecha y hora de la recompilación completa más reciente de la tabla persistente.
  • Si la tabla persistente es una PDT incremental, la fecha y hora de la recompilación incremental más reciente de la PDT.
  • Si la tabla persistente es una PDT incremental, la cantidad de recompilaciones incrementales que ocurrieron desde la recompilación completa más reciente.
  • El tiempo promedio que se tarda en volver a compilar la tabla persistente.
  • Es 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 tablas persistentes 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 nueva compilación, si las recompilaciones eran compilaciones incrementales, el activador que causó cada recompilación y la cantidad de compilaciones de tablas persistentes.
  • 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 tabla persistentes, incluido el número de ID del evento, la fecha, el tipo de evento y los datos que se incluyeron con el evento activador.
  • Una lista de todos los eventos de recompilación de tabla persistentes, incluido el número de ID del evento, la fecha, el tipo de evento y los datos que se incluyeron 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 tabla persistente.
  • Una lista de todos los campos de tabla persistentes consultados, incluidos la vista y el modelo de LookML en los que el campo está definido, el nombre del campo, el nombre de la ejecución de Explorar que incluyó el campo y la cantidad de veces que se incluyó en una consulta.

Explorar el registro de eventos de PDT

Looker incluye un modelo compilado previamente llamado system_activity que permite explorar 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 tablas persistentes.

Puede acceder al modelo con los enlaces 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 Administración 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 buscar una tabla persistente específica.

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

CampoDescripción
AcciónDescribe 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ónProporciona detalles más específicos sobre una acción, incluido el activador que se está usando, el valor de un activador, el tiempo de vencimiento de una tabla persistente, la causa de una recompilación y el texto de un mensaje de error.

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ónEl nombre de la conexión en la que existe la tabla derivada.
HashCada tabla derivada contiene un hash del SQL que se escribió para crearla.
IDEl ID único de la instancia de Looker que generó la tabla persistente. En muchos casos, solo habrá una instancia de Looker que apunta a una base de datos, por lo que verás un solo ID. Sin embargo, si tienes una instancia de etapa de pruebas, o algo similar, es posible que veas varios IDs.
Nombre del modeloEl nombre del modelo a través del cual se generó la tabla.
Fecha de ocurrenciaFecha y hora en que ocurrió el evento.
Ocurre la fecha de visualización de UtcEs la fecha y hora (UTC) en que ocurrió el evento.
SecuenciaUn número de paso en la compilación de la tabla persistente.
Hash cortoUna versión truncada del hash del SQL que se escribió para crear la tabla derivada.
Nombre de la tablaEl nombre completo de la tabla persistente, incluidos el prefijo del tipo de tabla, un hash y el nombre de la vista.
EmpateIndica el ID de transacción.
Nombre de la vistaEs el nombre de la vista de la tabla derivada.