As tabelas de sistema do Amazon Athena são tabelas Apache Iceberg gerenciadas pela AWS no Amazon S3 Tables, com registros de atividade que podem ser consultados no próprio Athena. A primeira, query_executions, reúne informações sobre consultas concluídas. Para acessá-la, a equipe precisa ativar o recurso e integrar o bucket ao AWS Glue Data Catalog; a captura abrange uma conta e uma região da AWS. A documentação do Athena detalha esses limites e requisitos.

Na prática, esses registros permitem analisar o histórico de consultas sem depender apenas de métricas agregadas: é possível examinar quem enviou uma consulta, quanto ela demorou e quantos bytes foram verificados.

O que query_executions registra

A AWS anunciou a tabela em 9 de novembro de 2026. Ela contém uma linha para cada consulta concluída, tanto em caso de sucesso quanto de erro; consultas ainda em execução não entram no registro. Entre os campos estão o texto e o identificador da consulta, o horário de envio, o grupo de trabalho, o catálogo e o banco de dados, a identidade de quem enviou a consulta, os tempos de execução, planejamento e espera, os bytes verificados, o estado e os detalhes de erro. O anúncio da AWS também especifica que dpu_count é preenchido apenas para consultas executadas em uma reserva de capacidade.

A tabela fica no bucket aws-athena, no Amazon S3 Tables, e usa Apache Iceberg. O nome completo para consultá-la é "s3tablescatalog/aws-athena"."metadata"."query_executions". A AWS recomenda filtrar pelas colunas de particionamento para reduzir a leitura de dados; para essa tabela, work_group_name é um exemplo.

Configuração e permissões necessárias

Antes de consultar os registros, a equipe precisa preparar a captura, o catálogo e o acesso:

  1. Ative as tabelas de sistema no console do Athena, em Administration → System tables → Configure. A ativação vale para todos os grupos de trabalho atuais e futuros da conta e região escolhidas.
  2. Integre o bucket do S3 Tables ao AWS Glue Data Catalog. Essa etapa é feita uma vez por conta e região. Para configurar a integração, o administrador precisa das permissões glue:CreateCatalog e glue:PassConnection.
  3. Conceda as permissões de consulta. Quem vai ler os registros precisa de acesso para executar consultas no Athena e gravar os resultados no local configurado para o grupo de trabalho, além de permissões de leitura no catálogo Glue e no S3 Tables e acesso aos dados pelo Lake Formation. Se a tabela usar uma chave gerenciada pelo cliente no AWS KMS, também são necessárias as permissões correspondentes do KMS.

A AWS usa SSE-S3 como criptografia padrão. Se a equipe escolher uma chave gerenciada pelo cliente, deve defini-la antes da criação da tabela: trocá-la depois exige excluir a tabela, removendo permanentemente os dados existentes, e recriá-la.

O limite de conta e região

A ativação cobre os grupos de trabalho de uma única conta e região da AWS. A consolidação entre contas ou entre regiões não é compatível com as tabelas de sistema do Athena. Uma equipe que precisa reunir essas operações em uma visão centralizada terá de considerar esse limite ao planejar sua arquitetura; ativar o recurso em uma conta e região não amplia a captura para as demais. O guia do Athena descreve o escopo do recurso.

Se a análise depende de uma visão entre várias contas ou regiões, trate essa necessidade como parte do desenho da arquitetura: a tabela não faz essa consolidação por conta própria.

Registros, privacidade e custos

Os dados chegam em lotes. Depois de gravados, os registros são imutáveis: não é possível inserir, atualizar ou excluir linhas individuais. Se a captura for desativada, ela deixa de produzir novos registros; ao reativá-la, o intervalo desativado não é preenchido retroativamente.

Não há expiração padrão configurada. A retenção deve ser definida no S3 Tables, com mínimo de um dia. A consulta pode incluir texto SQL com dados pessoais ou lógica proprietária, e a AWS não mascara esse conteúdo para o cliente. Por isso, o acesso deve ser controlado com IAM ou Lake Formation, conforme a política da equipe.

A entrega dos dados não tem cobrança. Já o armazenamento e a manutenção no S3 Tables, assim como as consultas executadas no Athena, têm cobranças padrão. A tabela oferece registros consultáveis para análise, mas seu custo operacional depende do armazenamento retido e das consultas feitas.

Como se compara a outras fontes do Athena

A AWS já oferecia dados de uso do Athena por APIs como GetQueryExecution, métricas do CloudWatch e logs do CloudTrail. query_executions acrescenta registros em formato Iceberg que podem ser consultados e combinados com outros dados; não substitui essas interfaces. Para comparar o desempenho ou o consumo de consultas concluídas dentro de um grupo de trabalho, a tabela reúne campos por execução. Para outras necessidades de métricas ou registros de atividade, as interfaces existentes continuam sendo alternativas documentadas pela AWS.