Las tablas de sistema de Amazon Athena permiten consultar registros de actividad de consultas completadas. La primera, query_executions, reúne consultas correctas y fallidas; para leer sus datos, AWS exige integrar el bucket de Amazon S3 Tables con AWS Glue Data Catalog. La captura se configura para una cuenta de AWS y una región, no para consolidar varias cuentas o regiones. AWS anunció la función el 9 de noviembre de 2026.

Qué registra query_executions

AWS describe una fila por cada consulta completada, tanto si terminó correctamente como si dio error. Las consultas que siguen en curso no aparecen. Cada registro puede incluir el identificador y el texto SQL, la hora de envío, el grupo de trabajo, el catálogo, la base de datos y las tablas, además de la identidad que envió la consulta, sus tiempos de ejecución, planificación y espera, los bytes examinados, el estado y los detalles del error.

El campo dpu_count solo contiene un valor para consultas ejecutadas con una reserva de capacidad. La tabla se almacena en formato Apache Iceberg en Amazon S3 Tables y su nombre completo es "s3tablescatalog/aws-athena"."metadata"."query_executions". Athena administra el esquema, las particiones, la compactación y el mantenimiento de instantáneas. La documentación de AWS detalla el formato y la estructura.

Athena ya ofrecía datos de uso mediante interfaces como GetQueryExecution, métricas de CloudWatch y registros de CloudTrail. La tabla de sistema permite consultar y combinar esos registros como datos en S3 Tables, sin tener que construir y mantener una canalización propia de historial; no sustituye las interfaces existentes.

Configuración y permisos necesarios

La función es opcional. En la consola de Athena, AWS indica que se activa desde Administration → System tables → Configure; la activación abarca los grupos de trabajo actuales y futuros de la cuenta y región elegidas. Antes de consultar los registros, hay que integrar el bucket de S3 Tables con AWS Glue Data Catalog. Esa integración se realiza una vez por cuenta y región.

Quien consulte la tabla necesita permisos para ejecutar consultas en Athena y escribir resultados en la ubicación correspondiente al grupo de trabajo, leer el catálogo de Glue y acceder a los datos de S3 Tables y Lake Formation. Si se usa una clave de AWS KMS administrada por el cliente, también hacen falta los permisos de KMS pertinentes. La guía de Amazon Athena distingue estos requisitos de acceso de los permisos necesarios para configurar la integración.

Para limitar los datos examinados al consultar la tabla, AWS recomienda filtrar por columnas de partición; en query_executions, pone como ejemplo work_group_name.

El alcance: una cuenta y una región

La configuración cubre los grupos de trabajo de una cuenta de AWS y una región. AWS no admite consolidar con esta función registros de varias cuentas o regiones. Si una organización necesita una vista conjunta de esos entornos, esta tabla por sí sola no ofrece ese alcance; el límite importa antes de elegirla como base para la observabilidad de toda la organización.

Retención, interrupciones, privacidad y costes

Los registros llegan por lotes y, una vez escritos, son inmutables: Athena no permite insertar, actualizar ni borrar filas individuales. No hay una caducidad predeterminada; la retención se configura mediante la expiración de registros de S3 Tables y admite un mínimo de un día. Si se desactiva la captura, las consultas de ese intervalo no se recuperan al volver a activarla.

El texto SQL puede contener datos personales o lógica propietaria. AWS no enmascara estos datos por cuenta del cliente, así que el acceso debe controlarse con IAM o Lake Formation. La seguridad también depende de la elección de cifrado: SSE-S3 es la opción predeterminada. Si se selecciona una clave de KMS administrada por el cliente, hay que hacerlo antes de crear la tabla; cambiarla después exige eliminar la tabla, lo que borra permanentemente sus datos, y volver a crearla.

Antes de depender del historial, define quién puede leer el texto de las consultas y cuánto tiempo deben conservarse los registros.

AWS no cobra por entregar los datos. Sí se aplican los cargos habituales de almacenamiento y mantenimiento de S3 Tables, y las consultas a la tabla generan los cargos estándar de Athena.