QueryExecutionStatus - Amazon Athena
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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 Amazon SDKs, see the following: