Amazon Athena
Amazon Athena Documentation (API Version 2017-05-18)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


Information about a single instance of a query execution.



The SQL query statements which the query execution ran.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 262144.

Required: No


The database in which the query execution occurred.

Type: QueryExecutionContext object

Required: No


The unique identifier for each query execution.

Type: String

Required: No


The location in Amazon S3 where query results were stored and the encryption option, if any, used for query results. These are known as "client-side settings". If workgroup settings override client-side settings, then the query uses the location for the query results and the encryption configuration that are specified for the workgroup.

Type: ResultConfiguration object

Required: No


The type of query statement that was run. DDL indicates DDL query statements. DML indicates DML (Data Manipulation Language) query statements, such as CREATE TABLE AS SELECT. UTILITY indicates query statements other than DDL and DML, such as SHOW CREATE TABLE, or DESCRIBE <table>.

Type: String

Valid Values: DDL | DML | UTILITY

Required: No


The amount of data scanned during the query execution and the amount of time that it took to execute, and the type of statement that was run.

Type: QueryExecutionStatistics object

Required: No


The completion date, current state, submission time, and state change reason (if applicable) for the query execution.

Type: QueryExecutionStatus object

Required: No


The name of the workgroup in which the query ran.

Type: String

Pattern: [a-zA-z0-9._-]{1,128}

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: