aws-sdk-athena 1.55.0 → 1.56.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d93a10bf117ae8c6ab4bb6e57c3fbe33d4b116abe69e9f38786486ebba621cfb
-  data.tar.gz: c08af9b491cbacbd85e97ed2a1e9b93fc56a716704e33ed780fe738d14da62d3
+  metadata.gz: 74be53714673ca3fa2a12aabe2c8cee44bc474d05cc982af921a6b462a4ba0cc
+  data.tar.gz: 2a6badd12bb32ddc909385ea984a845ca7d59a2608a0e6baa68a2832e5ede8b1
 SHA512:
-  metadata.gz: 88a9ab5998ed7f54646b12ca95e92ede86b620ef0cbd6686d081862cc145b0b906772de30601fb0e9701911919e3c67c5fe9f7e11dbb0bf487d503e05e1e9e04
-  data.tar.gz: e4113fed8f2052810d2db2883fed1715e46790e43595357b0c29cbfb71fe3a18a7ebb3a7313b63178bd067b84af0521281f7b2a901f94782aec384528b14d1e0
+  metadata.gz: a25ffa4171d27047a55191426c5646117b88bdb4cde400c658877a1e338c79183528826eed7691021c062378a95a4e6dbf3546813a9aacbb6b73d8b62382dfa8
+  data.tar.gz: a83cf1a9bdb900b53919eb5983fffbe9cc6395028f5822e3b5b6dc04948559a9cc12fb027cfeef58812c17c14222a57e551b2b3384535d12b6b22e6ee5d569b7

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.56.0 (2022-07-21)
+------------------
+
+* Feature - This feature allows customers to retrieve runtime statistics for completed queries
+
 1.55.0 (2022-07-14)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.55.0
+1.56.0

data/lib/aws-sdk-athena/client.rb

@@ -1175,6 +1175,60 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # @option params [required, String] :query_execution_id
+    #   The unique ID of the query execution.
+    #
+    # @return [Types::GetQueryRuntimeStatisticsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetQueryRuntimeStatisticsOutput#query_runtime_statistics #query_runtime_statistics} => Types::QueryRuntimeStatistics
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_query_runtime_statistics({
+    #     query_execution_id: "QueryExecutionId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.query_runtime_statistics.timeline.query_queue_time_in_millis #=> Integer
+    #   resp.query_runtime_statistics.timeline.query_planning_time_in_millis #=> Integer
+    #   resp.query_runtime_statistics.timeline.engine_execution_time_in_millis #=> Integer
+    #   resp.query_runtime_statistics.timeline.service_processing_time_in_millis #=> Integer
+    #   resp.query_runtime_statistics.timeline.total_execution_time_in_millis #=> Integer
+    #   resp.query_runtime_statistics.rows.input_rows #=> Integer
+    #   resp.query_runtime_statistics.rows.input_bytes #=> Integer
+    #   resp.query_runtime_statistics.rows.output_bytes #=> Integer
+    #   resp.query_runtime_statistics.rows.output_rows #=> Integer
+    #   resp.query_runtime_statistics.output_stage.stage_id #=> Integer
+    #   resp.query_runtime_statistics.output_stage.state #=> String
+    #   resp.query_runtime_statistics.output_stage.output_bytes #=> Integer
+    #   resp.query_runtime_statistics.output_stage.output_rows #=> Integer
+    #   resp.query_runtime_statistics.output_stage.input_bytes #=> Integer
+    #   resp.query_runtime_statistics.output_stage.input_rows #=> Integer
+    #   resp.query_runtime_statistics.output_stage.execution_time #=> Integer
+    #   resp.query_runtime_statistics.output_stage.query_stage_plan.name #=> String
+    #   resp.query_runtime_statistics.output_stage.query_stage_plan.identifier #=> String
+    #   resp.query_runtime_statistics.output_stage.query_stage_plan.children #=> Array
+    #   resp.query_runtime_statistics.output_stage.query_stage_plan.children[0] #=> Types::QueryStagePlanNode
+    #   resp.query_runtime_statistics.output_stage.query_stage_plan.remote_sources #=> Array
+    #   resp.query_runtime_statistics.output_stage.query_stage_plan.remote_sources[0] #=> String
+    #   resp.query_runtime_statistics.output_stage.sub_stages #=> Array
+    #   resp.query_runtime_statistics.output_stage.sub_stages[0] #=> Types::QueryStage
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryRuntimeStatistics AWS API Documentation
+    #
+    # @overload get_query_runtime_statistics(params = {})
+    # @param [Hash] params ({})
+    def get_query_runtime_statistics(params = {}, options = {})
+      req = build_request(:get_query_runtime_statistics, params)
+      req.send_request(options)
+    end
+
     # Returns table metadata for the specified catalog, database, and table.
     #
     # @option params [required, String] :catalog_name
@@ -1372,6 +1426,8 @@ module Aws::Athena
     #   * {Types::ListEngineVersionsOutput#engine_versions #engine_versions} => Array<Types::EngineVersion>
     #   * {Types::ListEngineVersionsOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_engine_versions({
@@ -2120,7 +2176,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.55.0'
+      context[:gem_version] = '1.56.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-athena/client_api.rb

@@ -82,6 +82,8 @@ module Aws::Athena
     GetQueryExecutionOutput = Shapes::StructureShape.new(name: 'GetQueryExecutionOutput')
     GetQueryResultsInput = Shapes::StructureShape.new(name: 'GetQueryResultsInput')
     GetQueryResultsOutput = Shapes::StructureShape.new(name: 'GetQueryResultsOutput')
+    GetQueryRuntimeStatisticsInput = Shapes::StructureShape.new(name: 'GetQueryRuntimeStatisticsInput')
+    GetQueryRuntimeStatisticsOutput = Shapes::StructureShape.new(name: 'GetQueryRuntimeStatisticsOutput')
     GetTableMetadataInput = Shapes::StructureShape.new(name: 'GetTableMetadataInput')
     GetTableMetadataOutput = Shapes::StructureShape.new(name: 'GetTableMetadataOutput')
     GetWorkGroupInput = Shapes::StructureShape.new(name: 'GetWorkGroupInput')
@@ -142,6 +144,13 @@ module Aws::Athena
     QueryExecutionState = Shapes::StringShape.new(name: 'QueryExecutionState')
     QueryExecutionStatistics = Shapes::StructureShape.new(name: 'QueryExecutionStatistics')
     QueryExecutionStatus = Shapes::StructureShape.new(name: 'QueryExecutionStatus')
+    QueryRuntimeStatistics = Shapes::StructureShape.new(name: 'QueryRuntimeStatistics')
+    QueryRuntimeStatisticsRows = Shapes::StructureShape.new(name: 'QueryRuntimeStatisticsRows')
+    QueryRuntimeStatisticsTimeline = Shapes::StructureShape.new(name: 'QueryRuntimeStatisticsTimeline')
+    QueryStage = Shapes::StructureShape.new(name: 'QueryStage')
+    QueryStagePlanNode = Shapes::StructureShape.new(name: 'QueryStagePlanNode')
+    QueryStagePlanNodes = Shapes::ListShape.new(name: 'QueryStagePlanNodes')
+    QueryStages = Shapes::ListShape.new(name: 'QueryStages')
     QueryString = Shapes::StringShape.new(name: 'QueryString')
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResultConfiguration = Shapes::StructureShape.new(name: 'ResultConfiguration')
@@ -159,6 +168,7 @@ module Aws::Athena
     StopQueryExecutionInput = Shapes::StructureShape.new(name: 'StopQueryExecutionInput')
     StopQueryExecutionOutput = Shapes::StructureShape.new(name: 'StopQueryExecutionOutput')
     String = Shapes::StringShape.new(name: 'String')
+    StringList = Shapes::ListShape.new(name: 'StringList')
     TableMetadata = Shapes::StructureShape.new(name: 'TableMetadata')
     TableMetadataList = Shapes::ListShape.new(name: 'TableMetadataList')
     TableTypeString = Shapes::StringShape.new(name: 'TableTypeString')
@@ -387,6 +397,12 @@ module Aws::Athena
     GetQueryResultsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
     GetQueryResultsOutput.struct_class = Types::GetQueryResultsOutput
 
+    GetQueryRuntimeStatisticsInput.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, required: true, location_name: "QueryExecutionId"))
+    GetQueryRuntimeStatisticsInput.struct_class = Types::GetQueryRuntimeStatisticsInput
+
+    GetQueryRuntimeStatisticsOutput.add_member(:query_runtime_statistics, Shapes::ShapeRef.new(shape: QueryRuntimeStatistics, location_name: "QueryRuntimeStatistics"))
+    GetQueryRuntimeStatisticsOutput.struct_class = Types::GetQueryRuntimeStatisticsOutput
+
     GetTableMetadataInput.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "CatalogName"))
     GetTableMetadataInput.add_member(:database_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "DatabaseName"))
     GetTableMetadataInput.add_member(:table_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "TableName"))
@@ -559,6 +575,45 @@ module Aws::Athena
     QueryExecutionStatus.add_member(:athena_error, Shapes::ShapeRef.new(shape: AthenaError, location_name: "AthenaError"))
     QueryExecutionStatus.struct_class = Types::QueryExecutionStatus
 
+    QueryRuntimeStatistics.add_member(:timeline, Shapes::ShapeRef.new(shape: QueryRuntimeStatisticsTimeline, location_name: "Timeline"))
+    QueryRuntimeStatistics.add_member(:rows, Shapes::ShapeRef.new(shape: QueryRuntimeStatisticsRows, location_name: "Rows"))
+    QueryRuntimeStatistics.add_member(:output_stage, Shapes::ShapeRef.new(shape: QueryStage, location_name: "OutputStage"))
+    QueryRuntimeStatistics.struct_class = Types::QueryRuntimeStatistics
+
+    QueryRuntimeStatisticsRows.add_member(:input_rows, Shapes::ShapeRef.new(shape: Long, location_name: "InputRows"))
+    QueryRuntimeStatisticsRows.add_member(:input_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "InputBytes"))
+    QueryRuntimeStatisticsRows.add_member(:output_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "OutputBytes"))
+    QueryRuntimeStatisticsRows.add_member(:output_rows, Shapes::ShapeRef.new(shape: Long, location_name: "OutputRows"))
+    QueryRuntimeStatisticsRows.struct_class = Types::QueryRuntimeStatisticsRows
+
+    QueryRuntimeStatisticsTimeline.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
+    QueryRuntimeStatisticsTimeline.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
+    QueryRuntimeStatisticsTimeline.add_member(:engine_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "EngineExecutionTimeInMillis"))
+    QueryRuntimeStatisticsTimeline.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
+    QueryRuntimeStatisticsTimeline.add_member(:total_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "TotalExecutionTimeInMillis"))
+    QueryRuntimeStatisticsTimeline.struct_class = Types::QueryRuntimeStatisticsTimeline
+
+    QueryStage.add_member(:stage_id, Shapes::ShapeRef.new(shape: Long, location_name: "StageId"))
+    QueryStage.add_member(:state, Shapes::ShapeRef.new(shape: String, location_name: "State"))
+    QueryStage.add_member(:output_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "OutputBytes"))
+    QueryStage.add_member(:output_rows, Shapes::ShapeRef.new(shape: Long, location_name: "OutputRows"))
+    QueryStage.add_member(:input_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "InputBytes"))
+    QueryStage.add_member(:input_rows, Shapes::ShapeRef.new(shape: Long, location_name: "InputRows"))
+    QueryStage.add_member(:execution_time, Shapes::ShapeRef.new(shape: Long, location_name: "ExecutionTime"))
+    QueryStage.add_member(:query_stage_plan, Shapes::ShapeRef.new(shape: QueryStagePlanNode, location_name: "QueryStagePlan"))
+    QueryStage.add_member(:sub_stages, Shapes::ShapeRef.new(shape: QueryStages, location_name: "SubStages"))
+    QueryStage.struct_class = Types::QueryStage
+
+    QueryStagePlanNode.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
+    QueryStagePlanNode.add_member(:identifier, Shapes::ShapeRef.new(shape: String, location_name: "Identifier"))
+    QueryStagePlanNode.add_member(:children, Shapes::ShapeRef.new(shape: QueryStagePlanNodes, location_name: "Children"))
+    QueryStagePlanNode.add_member(:remote_sources, Shapes::ShapeRef.new(shape: StringList, location_name: "RemoteSources"))
+    QueryStagePlanNode.struct_class = Types::QueryStagePlanNode
+
+    QueryStagePlanNodes.member = Shapes::ShapeRef.new(shape: QueryStagePlanNode)
+
+    QueryStages.member = Shapes::ShapeRef.new(shape: QueryStage)
+
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
     ResourceNotFoundException.add_member(:resource_name, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "ResourceName"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
@@ -607,6 +662,8 @@ module Aws::Athena
 
     StopQueryExecutionOutput.struct_class = Types::StopQueryExecutionOutput
 
+    StringList.member = Shapes::ShapeRef.new(shape: String)
+
     TableMetadata.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
     TableMetadata.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreateTime"))
     TableMetadata.add_member(:last_access_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastAccessTime"))
@@ -927,6 +984,16 @@ module Aws::Athena
         )
       end)
 
+      api.add_operation(:get_query_runtime_statistics, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "GetQueryRuntimeStatistics"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: GetQueryRuntimeStatisticsInput)
+        o.output = Shapes::ShapeRef.new(shape: GetQueryRuntimeStatisticsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:get_table_metadata, Seahorse::Model::Operation.new.tap do |o|
         o.name = "GetTableMetadata"
         o.http_method = "POST"
@@ -989,6 +1056,12 @@ module Aws::Athena
         o.output = Shapes::ShapeRef.new(shape: ListEngineVersionsOutput)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
       end)
 
       api.add_operation(:list_named_queries, Seahorse::Model::Operation.new.tap do |o|

data/lib/aws-sdk-athena/types.rb

@@ -1132,6 +1132,37 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass GetQueryRuntimeStatisticsInput
+    #   data as a hash:
+    #
+    #       {
+    #         query_execution_id: "QueryExecutionId", # required
+    #       }
+    #
+    # @!attribute [rw] query_execution_id
+    #   The unique ID of the query execution.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryRuntimeStatisticsInput AWS API Documentation
+    #
+    class GetQueryRuntimeStatisticsInput < Struct.new(
+      :query_execution_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] query_runtime_statistics
+    #   Runtime statistics about the query execution.
+    #   @return [Types::QueryRuntimeStatistics]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryRuntimeStatisticsOutput AWS API Documentation
+    #
+    class GetQueryRuntimeStatisticsOutput < Struct.new(
+      :query_runtime_statistics)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetTableMetadataInput
     #   data as a hash:
     #
@@ -2047,6 +2078,200 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # The query execution timeline, statistics on input and output rows and
+    # bytes, and the different query stages that form the query execution
+    # plan.
+    #
+    # @!attribute [rw] timeline
+    #   Timeline statistics such as query queue time, planning time,
+    #   execution time, service processing time, and total execution time.
+    #   @return [Types::QueryRuntimeStatisticsTimeline]
+    #
+    # @!attribute [rw] rows
+    #   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.
+    #   @return [Types::QueryRuntimeStatisticsRows]
+    #
+    # @!attribute [rw] output_stage
+    #   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.
+    #   @return [Types::QueryStage]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryRuntimeStatistics AWS API Documentation
+    #
+    class QueryRuntimeStatistics < Struct.new(
+      :timeline,
+      :rows,
+      :output_stage)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # 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.
+    #
+    # @!attribute [rw] input_rows
+    #   The number of rows read to execute the query.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] input_bytes
+    #   The number of bytes read to execute the query.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] output_bytes
+    #   The number of bytes returned by the query.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] output_rows
+    #   The number of rows returned by the query.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryRuntimeStatisticsRows AWS API Documentation
+    #
+    class QueryRuntimeStatisticsRows < Struct.new(
+      :input_rows,
+      :input_bytes,
+      :output_bytes,
+      :output_rows)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Timeline statistics such as query queue time, planning time, execution
+    # time, service processing time, and total execution time.
+    #
+    # @!attribute [rw] query_queue_time_in_millis
+    #   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.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] query_planning_time_in_millis
+    #   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.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] engine_execution_time_in_millis
+    #   The number of milliseconds that the query took to execute.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] service_processing_time_in_millis
+    #   The number of milliseconds that Athena took to finalize and publish
+    #   the query results after the query engine finished running the query.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] total_execution_time_in_millis
+    #   The number of milliseconds that Athena took to run the query.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryRuntimeStatisticsTimeline AWS API Documentation
+    #
+    class QueryRuntimeStatisticsTimeline < Struct.new(
+      :query_queue_time_in_millis,
+      :query_planning_time_in_millis,
+      :engine_execution_time_in_millis,
+      :service_processing_time_in_millis,
+      :total_execution_time_in_millis)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # 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.
+    #
+    # @!attribute [rw] stage_id
+    #   The identifier for a stage.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] state
+    #   State of the stage after query execution.
+    #   @return [String]
+    #
+    # @!attribute [rw] output_bytes
+    #   The number of bytes output from the stage after execution.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] output_rows
+    #   The number of rows output from the stage after execution.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] input_bytes
+    #   The number of bytes input into the stage for execution.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] input_rows
+    #   The number of rows input into the stage for execution.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] execution_time
+    #   Time taken to execute this stage.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] query_stage_plan
+    #   Stage plan information such as name, identifier, sub plans, and
+    #   source stages.
+    #   @return [Types::QueryStagePlanNode]
+    #
+    # @!attribute [rw] sub_stages
+    #   List of sub query stages that form this stage execution plan.
+    #   @return [Array<Types::QueryStage>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryStage AWS API Documentation
+    #
+    class QueryStage < Struct.new(
+      :stage_id,
+      :state,
+      :output_bytes,
+      :output_rows,
+      :input_bytes,
+      :input_rows,
+      :execution_time,
+      :query_stage_plan,
+      :sub_stages)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Stage plan information such as name, identifier, sub plans, and remote
+    # sources.
+    #
+    # @!attribute [rw] name
+    #   Name of the query stage plan that describes the operation this stage
+    #   is performing as part of query execution.
+    #   @return [String]
+    #
+    # @!attribute [rw] identifier
+    #   Information about the operation this query stage plan node is
+    #   performing.
+    #   @return [String]
+    #
+    # @!attribute [rw] children
+    #   Stage plan information such as name, identifier, sub plans, and
+    #   remote sources of child plan nodes/
+    #   @return [Array<Types::QueryStagePlanNode>]
+    #
+    # @!attribute [rw] remote_sources
+    #   Source plan node IDs.
+    #   @return [Array<String>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryStagePlanNode AWS API Documentation
+    #
+    class QueryStagePlanNode < Struct.new(
+      :name,
+      :identifier,
+      :children,
+      :remote_sources)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # A resource, such as a workgroup, was not found.
     #
     # @!attribute [rw] message

data/lib/aws-sdk-athena.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @!group service
 module Aws::Athena
 
-  GEM_VERSION = '1.55.0'
+  GEM_VERSION = '1.56.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.55.0
+  version: 1.56.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-07-14 00:00:00.000000000 Z
+date: 2022-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core