Le tabelle di sistema di Amazon Athena rendono interrogabili i dati sulle query completate. La prima, query_executions, registra le esecuzioni riuscite e quelle terminate con un errore; la raccolta si abilita per un singolo account e una singola Regione AWS. AWS ha annunciato la tabella il 9 novembre 2026, descrivendo anche l’integrazione con AWS Glue Data Catalog necessaria per interrogarla (annuncio AWS).
Prima di affidarti ai dati, considera insieme l’ambito di raccolta, i permessi di accesso e la conservazione: determinano quali attività entrano nel registro e per quanto tempo restano consultabili.
Cosa registra query_executions
La tabella contiene una riga per ogni query completata, sia con esito positivo sia con errore. Non comprende le esecuzioni ancora in corso. AWS indica tra i campi l’identificativo e il testo della query, l’ora di invio, il workgroup, il catalogo, il database, le tabelle coinvolte e l’identità di chi l’ha inviata; sono presenti anche tempi di esecuzione, pianificazione e attesa, byte analizzati, stato e dettagli dell’errore. dpu_count viene valorizzato soltanto per le query eseguite con una capacità riservata (documentazione AWS).
In pratica, questi dati permettono di interrogare e mettere in relazione la cronologia delle query per analizzare un carico di lavoro, attribuire i consumi o esaminare gli errori. AWS presenta le tabelle come un modo gestito per lavorare con questi record; si affiancano a interfacce già disponibili, come GetQueryExecution, CloudWatch e CloudTrail.
Athena archivia le tabelle in formato Apache Iceberg in un bucket Amazon S3 Tables del tuo account e della tua Regione. Il nome completo della tabella iniziale è "s3tablescatalog/aws-athena"."metadata"."query_executions". Athena gestisce schema, partizioni, compattazione e manutenzione degli snapshot; per contenere i dati letti, AWS raccomanda di filtrare sulle colonne di partizione, come work_group_name.
Configurazione e accessi necessari
L’attivazione è facoltativa e si configura dalla console Athena in Administration → System tables → Configure; AWS documenta anche le operazioni equivalenti tramite CLI e API. Prima di interrogare i record, il bucket S3 Tables deve essere integrato con AWS Glue Data Catalog: è un passaggio da eseguire una volta per account e Regione.
L’amministratore che configura l’integrazione ha bisogno delle autorizzazioni previste per quell’operazione, tra cui glue:CreateCatalog e glue:PassConnection. Chi legge i dati deve poter eseguire query in Athena, accedere in lettura al catalogo Glue e a S3 Tables e usare AWS Lake Formation per l’accesso ai dati. Servono inoltre i permessi per scrivere i risultati nella posizione associata al workgroup Athena. Se scegli una chiave KMS gestita dal cliente, occorrono anche le relative autorizzazioni KMS.
Il limite di account e Regione
Una volta abilitata, la raccolta copre tutti i workgroup attuali e futuri del singolo account AWS e della singola Regione scelti. AWS non supporta il consolidamento tra account diversi o tra Regioni diverse. Perciò un’unica attivazione non offre una vista aggregata di un’organizzazione distribuita su più account o Regioni.
Conservazione, interruzioni e dati sensibili
I record vengono consegnati in batch e non sono modificabili: non si possono inserire, aggiornare o cancellare righe singole. Nell’annuncio AWS descrive la disponibilità come generalmente nell’arco di pochi minuti dal completamento della query.
La raccolta non ha una scadenza predefinita. Puoi configurare la scadenza dei record tramite S3 Tables, con una conservazione minima di un giorno. Se disattivi le tabelle di sistema, durante l’interruzione non vengono raccolti nuovi dati e il periodo senza raccolta non viene recuperato quando riattivi la funzione.
Il testo delle query può contenere dati personali o logica proprietaria. AWS non maschera queste informazioni per il cliente: l’accesso va quindi governato con IAM o Lake Formation, in base a chi deve poter consultare i record.
AWS non applica costi per la consegna dei dati; la conservazione e la manutenzione in S3 Tables e le query eseguite in Athena comportano invece i rispettivi costi standard. Se configuri una chiave KMS gestita dal cliente, devi sceglierla prima della creazione della tabella: cambiarla in seguito richiede di eliminare la tabella, cancellandone definitivamente i dati, e ricrearla.