aws-sdk-dynamodb 1.71.0 → 1.74.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d7f505e912836b001b782b6a2511a5918ea5f7c889719f67725cefdd692d587e
-  data.tar.gz: e2411a26dc0de46c3f02bed05cd8d56b0f6e7981756757d04f09b71ebd892422
+  metadata.gz: 3fb6f3407dca16c38d88d28416d0fdf52f28f64a7d63fd7296a49758167dab79
+  data.tar.gz: d5fd2b88a65301e3cfa5866d290f1706f9f3c763a1f88b91d01a9f9d8a03e683
 SHA512:
-  metadata.gz: a80325166dcd65a4292e6980e9d4b036b72c8aff952534172c900ce77f162df692be1e53c3828c3f35186e4b64bda1572c5d4f50f4f9d5fb1124568734ec45fe
-  data.tar.gz: ee4b167a2a261ef17cffa0fc5668b3362d08a899ba8849651c6d6b707882cdbdb2bfb445855760e1204a9bcd9da899d548694e0a2f75a067ababcefc0c84fc9d
+  metadata.gz: 7b472f033d8b3f6e443c6777fbf6fb45ad39b19d35e796c20998aa197fbb2417db9a2830385f8c8a6034f374e31557bbe6f7eac654cde6a22dcd4fa642353865
+  data.tar.gz: 4ffe9f17116d8badd945895a8ae8a2215cabfa69818ee306bab547b68f81bae1be4953ed1b0f39ad4b6ac1d485022bfded7272d973997a537a99b5759ba069ee

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.74.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.73.0 (2022-02-21)
+------------------
+
+* Feature - DynamoDB ExecuteStatement API now supports Limit as a request parameter to specify the maximum number of items to evaluate. If specified, the service will process up to the Limit and the results will include a LastEvaluatedKey value to continue the read in a subsequent operation.
+
+1.72.0 (2022-02-03)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.71.0 (2022-02-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.71.0
+1.74.0

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

@@ -27,7 +27,9 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
+require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 require 'aws-sdk-dynamodb/plugins/extended_retries.rb'
@@ -77,7 +79,9 @@ module Aws::DynamoDB
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
+    add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
     add_plugin(Aws::DynamoDB::Plugins::ExtendedRetries)
@@ -3014,6 +3018,19 @@ module Aws::DynamoDB
     # This operation allows you to perform reads and singleton writes on
     # data stored in DynamoDB, using PartiQL.
     #
+    # For PartiQL reads (`SELECT` statement), if the total number of
+    # processed items exceeds the maximum dataset size limit of 1 MB, the
+    # read stops and results are returned to the user as a
+    # `LastEvaluatedKey` value to continue the read in a subsequent
+    # operation. If the filter criteria in `WHERE` clause does not match any
+    # data, the read will return an empty result set.
+    #
+    # A single `SELECT` statement response can return up to the maximum
+    # number of items (if using the Limit parameter) or a maximum of 1 MB of
+    # data (and then apply any filtering to the results using `WHERE`
+    # clause). If `LastEvaluatedKey` is present in the response, you need to
+    # paginate the result set.
+    #
     # @option params [required, String] :statement
     #   The PartiQL statement representing the operation to run.
     #
@@ -3046,11 +3063,24 @@ module Aws::DynamoDB
     #
     #   * `NONE` - No `ConsumedCapacity` details are included in the response.
     #
+    # @option params [Integer] :limit
+    #   The maximum number of items to evaluate (not necessarily the number of
+    #   matching items). If DynamoDB processes the number of items up to the
+    #   limit while processing the results, it stops the operation and returns
+    #   the matching values up to that point, along with a key in
+    #   `LastEvaluatedKey` to apply in a subsequent operation so you can pick
+    #   up where you left off. Also, if the processed dataset size exceeds 1
+    #   MB before DynamoDB reaches this limit, it stops the operation and
+    #   returns the matching values up to the limit, and a key in
+    #   `LastEvaluatedKey` to apply in a subsequent operation to continue the
+    #   operation.
+    #
     # @return [Types::ExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ExecuteStatementOutput#items #items} => Array<Hash<String,Types::AttributeValue>>
     #   * {Types::ExecuteStatementOutput#next_token #next_token} => String
     #   * {Types::ExecuteStatementOutput#consumed_capacity #consumed_capacity} => Types::ConsumedCapacity
+    #   * {Types::ExecuteStatementOutput#last_evaluated_key #last_evaluated_key} => Hash<String,Types::AttributeValue>
     #
     # @example Request syntax with placeholder values
     #
@@ -3060,6 +3090,7 @@ module Aws::DynamoDB
     #     consistent_read: false,
     #     next_token: "PartiQLNextToken",
     #     return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
+    #     limit: 1,
     #   })
     #
     # @example Response structure
@@ -3083,6 +3114,8 @@ module Aws::DynamoDB
     #   resp.consumed_capacity.global_secondary_indexes["IndexName"].read_capacity_units #=> Float
     #   resp.consumed_capacity.global_secondary_indexes["IndexName"].write_capacity_units #=> Float
     #   resp.consumed_capacity.global_secondary_indexes["IndexName"].capacity_units #=> Float
+    #   resp.last_evaluated_key #=> Hash
+    #   resp.last_evaluated_key["AttributeName"] #=> <Hash,Array,String,Numeric,Boolean,IO,Set,nil>
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatement AWS API Documentation
     #
@@ -7318,7 +7351,7 @@ module Aws::DynamoDB
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-dynamodb'
-      context[:gem_version] = '1.71.0'
+      context[:gem_version] = '1.74.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -835,11 +835,13 @@ module Aws::DynamoDB
     ExecuteStatementInput.add_member(:consistent_read, Shapes::ShapeRef.new(shape: ConsistentRead, location_name: "ConsistentRead"))
     ExecuteStatementInput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
     ExecuteStatementInput.add_member(:return_consumed_capacity, Shapes::ShapeRef.new(shape: ReturnConsumedCapacity, location_name: "ReturnConsumedCapacity"))
+    ExecuteStatementInput.add_member(:limit, Shapes::ShapeRef.new(shape: PositiveIntegerObject, location_name: "Limit"))
     ExecuteStatementInput.struct_class = Types::ExecuteStatementInput
 
     ExecuteStatementOutput.add_member(:items, Shapes::ShapeRef.new(shape: ItemList, location_name: "Items"))
     ExecuteStatementOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: PartiQLNextToken, location_name: "NextToken"))
     ExecuteStatementOutput.add_member(:consumed_capacity, Shapes::ShapeRef.new(shape: ConsumedCapacity, location_name: "ConsumedCapacity"))
+    ExecuteStatementOutput.add_member(:last_evaluated_key, Shapes::ShapeRef.new(shape: Key, location_name: "LastEvaluatedKey"))
     ExecuteStatementOutput.struct_class = Types::ExecuteStatementOutput
 
     ExecuteTransactionInput.add_member(:transact_statements, Shapes::ShapeRef.new(shape: ParameterizedStatements, required: true, location_name: "TransactStatements"))

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

@@ -3316,6 +3316,7 @@ module Aws::DynamoDB
     #         consistent_read: false,
     #         next_token: "PartiQLNextToken",
     #         return_consumed_capacity: "INDEXES", # accepts INDEXES, TOTAL, NONE
+    #         limit: 1,
     #       }
     #
     # @!attribute [rw] statement
@@ -3357,6 +3358,19 @@ module Aws::DynamoDB
     #     response.
     #   @return [String]
     #
+    # @!attribute [rw] limit
+    #   The maximum number of items to evaluate (not necessarily the number
+    #   of matching items). If DynamoDB processes the number of items up to
+    #   the limit while processing the results, it stops the operation and
+    #   returns the matching values up to that point, along with a key in
+    #   `LastEvaluatedKey` to apply in a subsequent operation so you can
+    #   pick up where you left off. Also, if the processed dataset size
+    #   exceeds 1 MB before DynamoDB reaches this limit, it stops the
+    #   operation and returns the matching values up to the limit, and a key
+    #   in `LastEvaluatedKey` to apply in a subsequent operation to continue
+    #   the operation.
+    #   @return [Integer]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatementInput AWS API Documentation
     #
     class ExecuteStatementInput < Struct.new(
@@ -3364,7 +3378,8 @@ module Aws::DynamoDB
       :parameters,
       :consistent_read,
       :next_token,
-      :return_consumed_capacity)
+      :return_consumed_capacity,
+      :limit)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3395,12 +3410,24 @@ module Aws::DynamoDB
     #   [1]: https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/ProvisionedThroughputIntro.html
     #   @return [Types::ConsumedCapacity]
     #
+    # @!attribute [rw] last_evaluated_key
+    #   The primary key of the item where the operation stopped, inclusive
+    #   of the previous result set. Use this value to start a new operation,
+    #   excluding this value in the new request. If `LastEvaluatedKey` is
+    #   empty, then the "last page" of results has been processed and
+    #   there is no more data to be retrieved. If `LastEvaluatedKey` is not
+    #   empty, it does not necessarily mean that there is more data in the
+    #   result set. The only way to know when you have reached the end of
+    #   the result set is when `LastEvaluatedKey` is empty.
+    #   @return [Hash<String,Types::AttributeValue>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/dynamodb-2012-08-10/ExecuteStatementOutput AWS API Documentation
     #
     class ExecuteStatementOutput < Struct.new(
       :items,
       :next_token,
-      :consumed_capacity)
+      :consumed_capacity,
+      :last_evaluated_key)
       SENSITIVE = []
       include Aws::Structure
     end

data/lib/aws-sdk-dynamodb.rb

@@ -50,6 +50,6 @@ require_relative 'aws-sdk-dynamodb/customizations'
 # @!group service
 module Aws::DynamoDB
 
-  GEM_VERSION = '1.71.0'
+  GEM_VERSION = '1.74.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-dynamodb
 version: !ruby/object:Gem::Version
-  version: 1.71.0
+  version: 1.74.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-02 00:00:00.000000000 Z
+date: 2022-02-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.125.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.125.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement