Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

QueryExecutionStatus - Amazon Athena

QueryExecutionStatus

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

Contents

AthenaError

Provides information about an Athena query error.

Type: AthenaError object

Required: No

CompletionDateTime

The date and time that the query completed.

Type: Timestamp

Required: No

State

The state of query execution. QUEUED indicates that the query has been submitted to the service, and Athena will execute the query as soon as resources are available. RUNNING indicates that the query is in execution phase. SUCCEEDED indicates that the query completed without errors. FAILED indicates that the query experienced an error and did not complete processing. CANCELLED indicates that a user input interrupted query execution.

Note

Athena automatically retries your queries in cases of certain transient errors. As a result, you may see the query state transition from RUNNING or FAILED to QUEUED.

Type: String

Valid Values: QUEUED | RUNNING | SUCCEEDED | FAILED | CANCELLED

Required: No

StateChangeReason

Further detail about the status of the query.

Type: String

Required: No

SubmissionDateTime

The date and time that the query was submitted.

Type: Timestamp

Required: No

See Also

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

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.