Note:
You are viewing the documentation for an older major version of the AWS CLI (version 1).AWS CLI version 2, the latest major version of AWS CLI, is now stable and recommended for general use. To view this page for the AWS CLI version 2, click here. For more information see the AWS CLI version 2 installation instructions and migration guide.
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. Query execution runtime statistics are returned only when QueryExecutionStatus$State is in a SUCCEEDED or FAILED state. Stage-level input and output row count and data size statistics are not shown when a query has row-level filters defined in Lake Formation.
See also: AWS API Documentation
Synopsis¶
get-query-runtime-statistics
--query-execution-id <value>
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
Options¶
--query-execution-id (string)
The unique ID of the query execution.
--cli-input-json (string)
Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI 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.
--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. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.
Global Options¶
--debug (boolean)
Turn on debug logging.
--endpoint-url (string)
Override command's default URL with the given URL.
--no-verify-ssl (boolean)
By default, the AWS CLI uses SSL when communicating with AWS services. For each SSL connection, the AWS CLI will verify SSL certificates. This option overrides the default behavior of verifying SSL certificates.
--no-paginate (boolean)
Disable automatic pagination.
--output (string)
The formatting style for command output.
- json
- text
- table
--query (string)
A JMESPath query to use in filtering the response data.
--profile (string)
Use a specific profile from your credential file.
--region (string)
The region to use. Overrides config/env settings.
--version (string)
Display the version of this tool.
--color (string)
Turn on/off color output.
- on
- off
- auto
--no-sign-request (boolean)
Do not sign requests. Credentials will not be loaded if this argument is provided.
--ca-bundle (string)
The CA certificate bundle to use when verifying SSL certificates. Overrides config/env settings.
--cli-read-timeout (int)
The maximum socket read time in seconds. If the value is set to 0, the socket read will be blocking and not timeout. The default value is 60 seconds.
--cli-connect-timeout (int)
The maximum socket connect time in seconds. If the value is set to 0, the socket connect will be blocking and not timeout. The default value is 60 seconds.
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.ServicePreProcessingTimeInMillis -> (long)
The number of milliseconds that Athena spends on preprocessing before it submits the query to the engine.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 ... )