get-query-runtime-statistics¶
Description¶
Returns query execution runtime statistics related to a single execution of a query if you have access to the workgroup in which the query ran. The query execution runtime statistics is returned only when QueryExecutionStatus$State is in a SUCCEEDED or FAILED state.
See also: AWS API Documentation
See ‘aws help’ for descriptions of global parameters.
Synopsis¶
get-query-runtime-statistics
--query-execution-id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
Options¶
--query-execution-id (string)
The unique ID of the query execution.
--cli-input-json | --cli-input-yaml (string)
Reads arguments from the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, those values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally. This may not be specified along with --cli-input-yaml.
--generate-cli-skeleton (string)
Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. Similarly, if provided yaml-input it will print a sample input YAML that can be used with --cli-input-yaml. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command. The generated JSON skeleton is not stable between versions of the AWS CLI and there are no backwards compatibility guarantees in the JSON skeleton generated.
See ‘aws help’ for descriptions of global parameters.
Output¶
QueryRuntimeStatistics -> (structure)
Runtime statistics about the query execution.
Timeline -> (structure)
Timeline statistics such as query queue time, planning time, execution time, service processing time, and total execution time.
QueryQueueTimeInMillis -> (long)
The number of milliseconds that the query was in your query queue waiting for resources. Note that if transient errors occur, Athena might automatically add the query back to the queue.
QueryPlanningTimeInMillis -> (long)
The number of milliseconds that Athena took to plan the query processing flow. This includes the time spent retrieving table partitions from the data source. Note that because the query engine performs the query planning, query planning time is a subset of engine processing time.
EngineExecutionTimeInMillis -> (long)
The number of milliseconds that the query took to execute.
ServiceProcessingTimeInMillis -> (long)
The number of milliseconds that Athena took to finalize and publish the query results after the query engine finished running the query.
TotalExecutionTimeInMillis -> (long)
The number of milliseconds that Athena took to run the query.
Rows -> (structure)
Statistics such as input rows and bytes read by the query, rows and bytes output by the query, and the number of rows written by the query.
InputRows -> (long)
The number of rows read to execute the query.
InputBytes -> (long)
The number of bytes read to execute the query.
OutputBytes -> (long)
The number of bytes returned by the query.
OutputRows -> (long)
The number of rows returned by the query.
OutputStage -> (structure)
Stage statistics such as input and output rows and bytes, execution time, and stage state. This information also includes substages and the query stage plan.
StageId -> (long)
The identifier for a stage.
State -> (string)
State of the stage after query execution.
OutputBytes -> (long)
The number of bytes output from the stage after execution.
OutputRows -> (long)
The number of rows output from the stage after execution.
InputBytes -> (long)
The number of bytes input into the stage for execution.
InputRows -> (long)
The number of rows input into the stage for execution.
ExecutionTime -> (long)
Time taken to execute this stage.
QueryStagePlan -> (structure)
Stage plan information such as name, identifier, sub plans, and source stages.
Name -> (string)
Name of the query stage plan that describes the operation this stage is performing as part of query execution.
Identifier -> (string)
Information about the operation this query stage plan node is performing.
Children -> (list)
Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/
(structure)
Stage plan information such as name, identifier, sub plans, and remote sources.
Name -> (string)
Name of the query stage plan that describes the operation this stage is performing as part of query execution.
Identifier -> (string)
Information about the operation this query stage plan node is performing.
Children -> (list)
Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/
( … recursive … )
RemoteSources -> (list)
Source plan node IDs.
(string)
RemoteSources -> (list)
Source plan node IDs.
(string)
SubStages -> (list)
List of sub query stages that form this stage execution plan.
(structure)
Stage statistics such as input and output rows and bytes, execution time and stage state. This information also includes substages and the query stage plan.
StageId -> (long)
The identifier for a stage.
State -> (string)
State of the stage after query execution.
OutputBytes -> (long)
The number of bytes output from the stage after execution.
OutputRows -> (long)
The number of rows output from the stage after execution.
InputBytes -> (long)
The number of bytes input into the stage for execution.
InputRows -> (long)
The number of rows input into the stage for execution.
ExecutionTime -> (long)
Time taken to execute this stage.
QueryStagePlan -> (structure)
Stage plan information such as name, identifier, sub plans, and source stages.
Name -> (string)
Name of the query stage plan that describes the operation this stage is performing as part of query execution.
Identifier -> (string)
Information about the operation this query stage plan node is performing.
Children -> (list)
Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/
(structure)
Stage plan information such as name, identifier, sub plans, and remote sources.
Name -> (string)
Name of the query stage plan that describes the operation this stage is performing as part of query execution.
Identifier -> (string)
Information about the operation this query stage plan node is performing.
Children -> (list)
Stage plan information such as name, identifier, sub plans, and remote sources of child plan nodes/
( … recursive … )
RemoteSources -> (list)
Source plan node IDs.
(string)
RemoteSources -> (list)
Source plan node IDs.
(string)
SubStages -> (list)
List of sub query stages that form this stage execution plan.
( … recursive … )