Legacy DynamoDB conditional parameters - Amazon DynamoDB (original) (raw)
This document provides an overview of legacy conditional parameters in DynamoDB and recommends using the new expression parameters instead. It covers details on parameters like AttributesToGet, AttributeUpdates, ConditionalOperator, Expected, KeyConditions, QueryFilter, and ScanFilter, and provides examples of how to use the new expression parameters as replacements.
Important
We recommend that you use the new expression parameters instead of these legacy parameters whenever possible. For more information, see Using expressions in DynamoDB.
Additionally, DynamoDB does not allow mixing legacy conditional parameters and expression parameters in a single call. For example, calling the Query operation withAttributesToGet and ConditionExpression will result in an error.
The following table shows the DynamoDB API operations that still support these legacy parameters, and which expression parameter to use instead. This table can be helpful if you are considering updating your applications so that they use expression parameters instead.
| If you use this API operation... | With these legacy parameters... | Use this expression parameter instead |
|---|---|---|
| BatchGetItem | AttributesToGet | ProjectionExpression |
| DeleteItem | Expected | ConditionExpression |
| GetItem | AttributesToGet | ProjectionExpression |
| PutItem | Expected | ConditionExpression |
| Query | AttributesToGet | ProjectionExpression |
| KeyConditions | KeyConditionExpression | |
| QueryFilter | FilterExpression | |
| Scan | AttributesToGet | ProjectionExpression |
| ScanFilter | FilterExpression | |
| UpdateItem | AttributeUpdates | UpdateExpression |
| Expected | ConditionExpression |
The following sections provide more information about legacy conditional parameters.
Topics
- AttributesToGet (legacy)
- AttributeUpdates (legacy)
- ConditionalOperator (legacy)
- Expected (legacy)
- KeyConditions (legacy)
- QueryFilter (legacy)
- ScanFilter (legacy)
- Writing conditions with legacy parameters
UpdateTable
AttributesToGet
Did this page help you? - Yes
Thanks for letting us know we're doing a good job!
If you've got a moment, please tell us what we did right so we can do more of it.
Did this page help you? - No
Thanks for letting us know this page needs work. We're sorry we let you down.
If you've got a moment, please tell us how we can make the documentation better.