GetQueryExecution
Returns information about a single execution of a query if you have access to the workgroup in which the query ran. Each time a query executes, information about the query execution is saved with a unique ID.
Request Syntax
{
"QueryExecutionId": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- QueryExecutionId
-
The unique ID of the query execution.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 128.
Pattern:
\S+
Required: Yes
Response Syntax
{
"QueryExecution": {
"EngineVersion": {
"EffectiveEngineVersion": "string",
"SelectedEngineVersion": "string"
},
"ExecutionParameters": [ "string" ],
"Query": "string",
"QueryExecutionContext": {
"Catalog": "string",
"Database": "string"
},
"QueryExecutionId": "string",
"QueryResultsS3AccessGrantsConfiguration": {
"AuthenticationType": "string",
"CreateUserLevelPrefix": boolean,
"EnableS3AccessGrants": boolean
},
"ResultConfiguration": {
"AclConfiguration": {
"S3AclOption": "string"
},
"EncryptionConfiguration": {
"EncryptionOption": "string",
"KmsKey": "string"
},
"ExpectedBucketOwner": "string",
"OutputLocation": "string"
},
"ResultReuseConfiguration": {
"ResultReuseByAgeConfiguration": {
"Enabled": boolean,
"MaxAgeInMinutes": number
}
},
"StatementType": "string",
"Statistics": {
"DataManifestLocation": "string",
"DataScannedInBytes": number,
"EngineExecutionTimeInMillis": number,
"QueryPlanningTimeInMillis": number,
"QueryQueueTimeInMillis": number,
"ResultReuseInformation": {
"ReusedPreviousResult": boolean
},
"ServicePreProcessingTimeInMillis": number,
"ServiceProcessingTimeInMillis": number,
"TotalExecutionTimeInMillis": number
},
"Status": {
"AthenaError": {
"ErrorCategory": number,
"ErrorMessage": "string",
"ErrorType": number,
"Retryable": boolean
},
"CompletionDateTime": number,
"State": "string",
"StateChangeReason": "string",
"SubmissionDateTime": number
},
"SubstatementType": "string",
"WorkGroup": "string"
}
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- QueryExecution
-
Information about the query execution.
Type: QueryExecution object
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerException
-
Indicates a platform issue, which may be due to a transient condition or outage.
HTTP Status Code: 500
- InvalidRequestException
-
Indicates that something is wrong with the input to the request. For example, a required parameter may be missing or out of range.
HTTP Status Code: 400
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: