aws-sdk-athena 1.57.0 → 1.58.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e34f601fcf51380c748dbd3595e720808fa00c01ceca0ebe652b53b1fa1b7184
-  data.tar.gz: cb4ea48fb27f210100ee23f7f8264aefaea1de779453dcb95375a3e08bc3b6f2
+  metadata.gz: 495bf4b658faeea93f6a7e46ffee9e125ea3e0f1721a1976ab969ad02d025288
+  data.tar.gz: f5e14db3cbb8fbc9ea2d50fc50e42233ecfe9a9e5373e54dce26e4fd33c103f0
 SHA512:
-  metadata.gz: 1b79e2c2b5a54c9bb76029fc1ea5006098fcf47938587ad8515f1a662a7da6067b1647c224d8fec2c33c734b0d76fd0b21db16e8330d1fe0ec72c14232e1df4f
-  data.tar.gz: 56fc0bb9205f293e4a5887a8de61336b9638abb641e8efcd91bbd8198872876394f9a983c3ec927ffdb2e8dfdb1fa836615f813d303fb1889015adfde3b48802
+  metadata.gz: 0a58c4df679026bde7dce71a2ec550af96d6e098f5c355cbe68b4a1644a8c27f2749bca1beba2c35461d6f04ae2a6fcb3d58a2d865328fbce16f04c1cd2a7c98
+  data.tar.gz: 21c7df8e5f391324dc42009b37de53c70a596d4ed080d889ac3e326525b0968ebe6ff17798f10e3e461335c504ceef87c724739b4e885b8e7a0f7f6475a54640

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.58.0 (2022-11-07)
+------------------
+
+* Feature - Adds support for using Query Result Reuse
+
 1.57.0 (2022-10-25)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.57.0
+1.58.0

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

@@ -506,6 +506,8 @@ module Aws::Athena
     #   resp.query_executions[0].result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_executions[0].result_configuration.expected_bucket_owner #=> String
     #   resp.query_executions[0].result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
+    #   resp.query_executions[0].result_reuse_configuration.result_reuse_by_age_configuration.enabled #=> Boolean
+    #   resp.query_executions[0].result_reuse_configuration.result_reuse_by_age_configuration.max_age_in_minutes #=> Integer
     #   resp.query_executions[0].query_execution_context.database #=> String
     #   resp.query_executions[0].query_execution_context.catalog #=> String
     #   resp.query_executions[0].status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
@@ -523,6 +525,7 @@ module Aws::Athena
     #   resp.query_executions[0].statistics.query_queue_time_in_millis #=> Integer
     #   resp.query_executions[0].statistics.query_planning_time_in_millis #=> Integer
     #   resp.query_executions[0].statistics.service_processing_time_in_millis #=> Integer
+    #   resp.query_executions[0].statistics.result_reuse_information.reused_previous_result #=> Boolean
     #   resp.query_executions[0].work_group #=> String
     #   resp.query_executions[0].engine_version.selected_engine_version #=> String
     #   resp.query_executions[0].engine_version.effective_engine_version #=> String
@@ -1084,6 +1087,8 @@ module Aws::Athena
     #   resp.query_execution.result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_execution.result_configuration.expected_bucket_owner #=> String
     #   resp.query_execution.result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
+    #   resp.query_execution.result_reuse_configuration.result_reuse_by_age_configuration.enabled #=> Boolean
+    #   resp.query_execution.result_reuse_configuration.result_reuse_by_age_configuration.max_age_in_minutes #=> Integer
     #   resp.query_execution.query_execution_context.database #=> String
     #   resp.query_execution.query_execution_context.catalog #=> String
     #   resp.query_execution.status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
@@ -1101,6 +1106,7 @@ module Aws::Athena
     #   resp.query_execution.statistics.query_queue_time_in_millis #=> Integer
     #   resp.query_execution.statistics.query_planning_time_in_millis #=> Integer
     #   resp.query_execution.statistics.service_processing_time_in_millis #=> Integer
+    #   resp.query_execution.statistics.result_reuse_information.reused_previous_result #=> Boolean
     #   resp.query_execution.work_group #=> String
     #   resp.query_execution.engine_version.selected_engine_version #=> String
     #   resp.query_execution.engine_version.effective_engine_version #=> String
@@ -1834,6 +1840,9 @@ module Aws::Athena
     #   sequentially to the parameters in the query in the order in which the
     #   parameters occur.
     #
+    # @option params [Types::ResultReuseConfiguration] :result_reuse_configuration
+    #   Specifies the query result reuse behavior for the query.
+    #
     # @return [Types::StartQueryExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartQueryExecutionOutput#query_execution_id #query_execution_id} => String
@@ -1860,6 +1869,12 @@ module Aws::Athena
     #     },
     #     work_group: "WorkGroupName",
     #     execution_parameters: ["ExecutionParameter"],
+    #     result_reuse_configuration: {
+    #       result_reuse_by_age_configuration: {
+    #         enabled: false, # required
+    #         max_age_in_minutes: 1,
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -2193,7 +2208,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.57.0'
+      context[:gem_version] = '1.58.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -14,6 +14,7 @@ module Aws::Athena
     include Seahorse::Model
 
     AclConfiguration = Shapes::StructureShape.new(name: 'AclConfiguration')
+    Age = Shapes::IntegerShape.new(name: 'Age')
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
     AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
     AwsAccountId = Shapes::StringShape.new(name: 'AwsAccountId')
@@ -156,6 +157,9 @@ module Aws::Athena
     ResultConfiguration = Shapes::StructureShape.new(name: 'ResultConfiguration')
     ResultConfigurationUpdates = Shapes::StructureShape.new(name: 'ResultConfigurationUpdates')
     ResultOutputLocation = Shapes::StringShape.new(name: 'ResultOutputLocation')
+    ResultReuseByAgeConfiguration = Shapes::StructureShape.new(name: 'ResultReuseByAgeConfiguration')
+    ResultReuseConfiguration = Shapes::StructureShape.new(name: 'ResultReuseConfiguration')
+    ResultReuseInformation = Shapes::StructureShape.new(name: 'ResultReuseInformation')
     ResultSet = Shapes::StructureShape.new(name: 'ResultSet')
     ResultSetMetadata = Shapes::StructureShape.new(name: 'ResultSetMetadata')
     Row = Shapes::StructureShape.new(name: 'Row')
@@ -543,6 +547,7 @@ module Aws::Athena
     QueryExecution.add_member(:query, Shapes::ShapeRef.new(shape: QueryString, location_name: "Query"))
     QueryExecution.add_member(:statement_type, Shapes::ShapeRef.new(shape: StatementType, location_name: "StatementType"))
     QueryExecution.add_member(:result_configuration, Shapes::ShapeRef.new(shape: ResultConfiguration, location_name: "ResultConfiguration"))
+    QueryExecution.add_member(:result_reuse_configuration, Shapes::ShapeRef.new(shape: ResultReuseConfiguration, location_name: "ResultReuseConfiguration"))
     QueryExecution.add_member(:query_execution_context, Shapes::ShapeRef.new(shape: QueryExecutionContext, location_name: "QueryExecutionContext"))
     QueryExecution.add_member(:status, Shapes::ShapeRef.new(shape: QueryExecutionStatus, location_name: "Status"))
     QueryExecution.add_member(:statistics, Shapes::ShapeRef.new(shape: QueryExecutionStatistics, location_name: "Statistics"))
@@ -566,6 +571,7 @@ module Aws::Athena
     QueryExecutionStatistics.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
     QueryExecutionStatistics.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
     QueryExecutionStatistics.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
+    QueryExecutionStatistics.add_member(:result_reuse_information, Shapes::ShapeRef.new(shape: ResultReuseInformation, location_name: "ResultReuseInformation"))
     QueryExecutionStatistics.struct_class = Types::QueryExecutionStatistics
 
     QueryExecutionStatus.add_member(:state, Shapes::ShapeRef.new(shape: QueryExecutionState, location_name: "State"))
@@ -634,6 +640,16 @@ module Aws::Athena
     ResultConfigurationUpdates.add_member(:remove_acl_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveAclConfiguration"))
     ResultConfigurationUpdates.struct_class = Types::ResultConfigurationUpdates
 
+    ResultReuseByAgeConfiguration.add_member(:enabled, Shapes::ShapeRef.new(shape: Boolean, required: true, location_name: "Enabled"))
+    ResultReuseByAgeConfiguration.add_member(:max_age_in_minutes, Shapes::ShapeRef.new(shape: Age, location_name: "MaxAgeInMinutes"))
+    ResultReuseByAgeConfiguration.struct_class = Types::ResultReuseByAgeConfiguration
+
+    ResultReuseConfiguration.add_member(:result_reuse_by_age_configuration, Shapes::ShapeRef.new(shape: ResultReuseByAgeConfiguration, location_name: "ResultReuseByAgeConfiguration"))
+    ResultReuseConfiguration.struct_class = Types::ResultReuseConfiguration
+
+    ResultReuseInformation.add_member(:reused_previous_result, Shapes::ShapeRef.new(shape: Boolean, required: true, location_name: "ReusedPreviousResult"))
+    ResultReuseInformation.struct_class = Types::ResultReuseInformation
+
     ResultSet.add_member(:rows, Shapes::ShapeRef.new(shape: RowList, location_name: "Rows"))
     ResultSet.add_member(:result_set_metadata, Shapes::ShapeRef.new(shape: ResultSetMetadata, location_name: "ResultSetMetadata"))
     ResultSet.struct_class = Types::ResultSet
@@ -652,6 +668,7 @@ module Aws::Athena
     StartQueryExecutionInput.add_member(:result_configuration, Shapes::ShapeRef.new(shape: ResultConfiguration, location_name: "ResultConfiguration"))
     StartQueryExecutionInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
     StartQueryExecutionInput.add_member(:execution_parameters, Shapes::ShapeRef.new(shape: ExecutionParameters, location_name: "ExecutionParameters"))
+    StartQueryExecutionInput.add_member(:result_reuse_configuration, Shapes::ShapeRef.new(shape: ResultReuseConfiguration, location_name: "ResultReuseConfiguration"))
     StartQueryExecutionInput.struct_class = Types::StartQueryExecutionInput
 
     StartQueryExecutionOutput.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, location_name: "QueryExecutionId"))
@@ -976,6 +993,7 @@ module Aws::Athena
         o.output = Shapes::ShapeRef.new(shape: GetQueryResultsOutput)
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+        o.errors << Shapes::ShapeRef.new(shape: TooManyRequestsException)
         o[:pager] = Aws::Pager.new(
           limit_key: "max_results",
           tokens: {

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

@@ -1892,6 +1892,11 @@ module Aws::Athena
     #   workgroup.
     #   @return [Types::ResultConfiguration]
     #
+    # @!attribute [rw] result_reuse_configuration
+    #   Specifies the query result reuse behavior that was used for the
+    #   query.
+    #   @return [Types::ResultReuseConfiguration]
+    #
     # @!attribute [rw] query_execution_context
     #   The database in which the query execution occurred.
     #   @return [Types::QueryExecutionContext]
@@ -1928,6 +1933,7 @@ module Aws::Athena
       :query,
       :statement_type,
       :result_configuration,
+      :result_reuse_configuration,
       :query_execution_context,
       :status,
       :statistics,
@@ -2017,6 +2023,11 @@ module Aws::Athena
     #   the query results after the query engine finished running the query.
     #   @return [Integer]
     #
+    # @!attribute [rw] result_reuse_information
+    #   Contains information about whether previous query results were
+    #   reused for the query.
+    #   @return [Types::ResultReuseInformation]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionStatistics AWS API Documentation
     #
     class QueryExecutionStatistics < Struct.new(
@@ -2026,7 +2037,8 @@ module Aws::Athena
       :total_execution_time_in_millis,
       :query_queue_time_in_millis,
       :query_planning_time_in_millis,
-      :service_processing_time_in_millis)
+      :service_processing_time_in_millis,
+      :result_reuse_information)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2532,6 +2544,77 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # Specifies whether previous query results are reused, and if so, their
+    # maximum age.
+    #
+    # @note When making an API call, you may pass ResultReuseByAgeConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         enabled: false, # required
+    #         max_age_in_minutes: 1,
+    #       }
+    #
+    # @!attribute [rw] enabled
+    #   True if previous query results can be reused when the query is run;
+    #   otherwise, false. The default is false.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] max_age_in_minutes
+    #   Specifies, in minutes, the maximum age of a previous query result
+    #   that Athena should consider for reuse. The default is 60.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultReuseByAgeConfiguration AWS API Documentation
+    #
+    class ResultReuseByAgeConfiguration < Struct.new(
+      :enabled,
+      :max_age_in_minutes)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Specifies the query result reuse behavior for the query.
+    #
+    # @note When making an API call, you may pass ResultReuseConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         result_reuse_by_age_configuration: {
+    #           enabled: false, # required
+    #           max_age_in_minutes: 1,
+    #         },
+    #       }
+    #
+    # @!attribute [rw] result_reuse_by_age_configuration
+    #   Specifies whether previous query results are reused, and if so,
+    #   their maximum age.
+    #   @return [Types::ResultReuseByAgeConfiguration]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultReuseConfiguration AWS API Documentation
+    #
+    class ResultReuseConfiguration < Struct.new(
+      :result_reuse_by_age_configuration)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains information about whether the result of a previous query was
+    # reused.
+    #
+    # @!attribute [rw] reused_previous_result
+    #   True if a previous query result was reused; false if the result was
+    #   generated from a new run of the query.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultReuseInformation AWS API Documentation
+    #
+    class ResultReuseInformation < Struct.new(
+      :reused_previous_result)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # The metadata and rows that make up a query result set. The metadata
     # describes the column structure and data types. To return a `ResultSet`
     # object, use GetQueryResults.
@@ -2607,6 +2690,12 @@ module Aws::Athena
     #         },
     #         work_group: "WorkGroupName",
     #         execution_parameters: ["ExecutionParameter"],
+    #         result_reuse_configuration: {
+    #           result_reuse_by_age_configuration: {
+    #             enabled: false, # required
+    #             max_age_in_minutes: 1,
+    #           },
+    #         },
     #       }
     #
     # @!attribute [rw] query_string
@@ -2654,6 +2743,10 @@ module Aws::Athena
     #   which the parameters occur.
     #   @return [Array<String>]
     #
+    # @!attribute [rw] result_reuse_configuration
+    #   Specifies the query result reuse behavior for the query.
+    #   @return [Types::ResultReuseConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecutionInput AWS API Documentation
     #
     class StartQueryExecutionInput < Struct.new(
@@ -2662,7 +2755,8 @@ module Aws::Athena
       :query_execution_context,
       :result_configuration,
       :work_group,
-      :execution_parameters)
+      :execution_parameters,
+      :result_reuse_configuration)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-athena.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @!group service
 module Aws::Athena
 
-  GEM_VERSION = '1.57.0'
+  GEM_VERSION = '1.58.0'
 
 end

metadata

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