DynamoDbEnhancedClient allow to request to return capacity on all data plane operations

[arjanschaaf]

Describe the feature

#2095 added ReturnConsumedCapacity for putItem, updateItem and deleteItem operations, but other Data plane operations should allow you to request to return consumed capacity as offered by the DynamoDB API on their (paged) return.

This should include the following Data plane operations:

• DynamoDbEnhancedClient.batchGetItem
• DynamoDbEnhancedClient.batchWriteItem
• DynamoDbEnhancedClient.transactGetItems
• DynamoDbEnhancedClient.transactWriteItems
• DynamoDbTable.getitem
• DynamoDbTable.query
• DynamoDbTable.scan

Use Case

Common scenario is to request to the DynamoDB API to return the consumed capacity to log or debug the read or write capacity used by the data plane operation.

Proposed Solution

Continue by adding functionality introduced in #2095 by either adding *WithResponse methods to these classes or extend the existing response objects to include the consumed capacity.

Other Information

No response

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

AWS Java SDK version used

2.20.88

JDK version used

OpenJDK Runtime Environment Corretto-20.0.1.9.1 (build 20.0.1+9-FR)

Operating System and version

macOS Ventura 13.4

[debora-ito]

That's fair, feature request acknowledged.

Community note: please show your support by adding a 👍 to the original description above to help us prioritize this request.

[debora-ito]

Quick update:

ReturnConsumedCapacity is now supported by :

• GetItem (and TransactGetItems as a consequence), as part of version 2.20.146 (via #4375)
• BatchGetItem, as part of 2.20.147 (via #4421)

[debora-ito]

Query and Scan now support ConsumedCapacity too, since version 2.20.153 (via #4444).

[prateek-vats]

Query and Scan now support ConsumedCapacity too, since version 2.20.153 (via #4444).

Hi @debora-ito - Any plans on supporting BatchWriteItem and TransactWriteItem in the future?

[prateek-vats]

Query and Scan now support ConsumedCapacity too, since version 2.20.153 (via #4444).

Hi @debora-ito - Any plans on supporting BatchWriteItem and TransactWriteItem in the future?

I can take a stab at it, if this has not been implemented yet

[prateek-vats]

Here's a PR for supporting ConsumedCapacity in BatchWriteItems and TransactWriteItems
#5462