query_executions to tabela systemowa Amazon Athena z danymi o zakończonych zapytaniach. AWS ogłosiło ją 9 listopada 2026 r. jako pierwszą tabelę systemową Athena; dla zespołu oznacza to możliwość analizowania historii zapytań bez budowania własnego potoku do gromadzenia tych rekordów. Zanim zaczniesz z niej korzystać, uwzględnij jednak zakres jednego konta i regionu AWS oraz konfigurację katalogu danych.

Najpierw sprawdź, czy jedno konto i region wystarczą twojemu zespołowi. Tabela nie łączy danych z wielu kont ani regionów.

Co rejestruje query_executions

Tabela zawiera jeden wiersz dla każdego zakończonego zapytania, niezależnie od tego, czy zakończyło się powodzeniem, czy błędem. Zapytania nadal wykonywane nie trafiają do tabeli. AWS wymienia wśród pól identyfikator i tekst zapytania, czas jego wysłania, grupę roboczą, kontekst katalogu i bazy danych, użyte tabele oraz tożsamość osoby lub podmiotu, który je uruchomił. Zapis obejmuje też czasy planowania, oczekiwania i wykonania, liczbę zeskanowanych bajtów, stan zapytania i szczegóły błędu. Pole dpu_count wypełnia się tylko w przypadku zapytań działających w ramach rezerwacji pojemności. Szczegóły podało AWS w ogłoszeniu o tabelach systemowych Athena.

Dane są przechowywane jako tabele Apache Iceberg w Amazon S3 Tables, w zasobniku aws-athena na koncie i w regionie klienta. AWS zarządza schematem, partycjonowaniem, kompaktowaniem i migawkami tabeli. Jej pełna nazwa to "s3tablescatalog/aws-athena"."metadata"."query_executions". Przy analizie AWS zaleca filtrowanie po kolumnach partycji; dla tej tabeli przykładem jest work_group_name, czyli nazwa grupy roboczej.

Systemowa tabela daje dane, które można odpytywać i łączyć z innymi zbiorami. Wcześniej informacje o użyciu Athena można było pozyskiwać między innymi przez API GetQueryExecution, metryki Amazon CloudWatch i dzienniki AWS CloudTrail. Nowa tabela oferuje zarządzany format do analizy rekordów zapytań; AWS przedstawia ją jako sposób na ograniczenie potrzeby budowania własnych potoków historii, a nie zastępstwo dla tych interfejsów.

Konfiguracja i dostęp do danych

Funkcję trzeba włączyć w konsoli Athena, w sekcji Administration → System tables → Configure, albo skonfigurować przez interfejs CLI lub API Athena. Przed odpytywaniem tabeli zasobnik S3 Tables musi być zintegrowany z AWS Glue Data Catalog. To jednorazowa konfiguracja dla danego konta i regionu AWS. AWS opisuje ją w dokumentacji tabel systemowych Athena.

Samo włączenie zapisu nie daje użytkownikom automatycznie dostępu do odczytu. Osoba wykonująca zapytania potrzebuje odpowiednich uprawnień do Athena, odczytu katalogu Glue i danych w S3 Tables, a także dostępu do lokalizacji wyników swojej grupy roboczej. Dostęp do danych można kontrolować przez IAM lub AWS Lake Formation. Jeśli używasz klucza AWS KMS zarządzanego przez klienta, potrzebne są również uprawnienia KMS.

Zakres jednego konta i regionu AWS

Po włączeniu funkcja obejmuje wszystkie obecne i przyszłe grupy robocze w danym koncie i regionie AWS. AWS nie obsługuje konsolidowania tych tabel między kontami ani regionami. Jeśli zespół korzysta z kilku kont lub regionów, pojedyncze włączenie nie zapewni mu wspólnego zbioru rekordów ze wszystkich tych środowisk.

Retencja, przerwy w zapisie i ochrona danych

AWS nie ustawia domyślnego terminu wygaśnięcia rekordów. Retencję trzeba skonfigurować w S3 Tables; jej minimum to jeden dzień, a dokumentacja nie określa górnego limitu. Rekordy są dostarczane raz i pozostają niezmienne: nie można pojedynczo dodawać, aktualizować ani usuwać ich w tabeli. Gdy funkcja jest wyłączona, nowe dane nie są zapisywane, a po ponownym włączeniu luka z tego okresu nie zostaje uzupełniona.

Tekst zapytań może zawierać dane osobowe lub poufną logikę biznesową. AWS nie maskuje tych informacji za klienta, dlatego dostęp do tabeli powinien podlegać tym samym przemyślanym zasadom uprawnień co inne wrażliwe dane. Domyślnie dane są szyfrowane przez SSE-S3. Jeśli wybierzesz własny klucz KMS, po utworzeniu tabeli nie można go zmienić bez jej usunięcia; usunięcie tabeli bezpowrotnie kasuje zapisane dane.

AWS nie pobiera opłaty za dostarczanie rekordów. Standardowe opłaty dotyczą natomiast przechowywania i utrzymania danych w S3 Tables oraz zapytań wykonywanych w Athena.