レガシー DynamoDB 条件パラメータ
このドキュメントでは、DynamoDB のレガシー条件パラメータの概要を示し、代わりに新しい式パラメータの使用を推奨します。AttributesToGet、AttributeUpdates、ConditionalOperator、Expected、KeyConditions、QueryFilter、ScanFilter などのパラメータの詳細と、新しい式パラメータを代わりに使用する方法の例を示します。
重要
可能な限り、これらのレガシーパラメータの代わりに新しい式パラメータを使用することをお勧めします。詳細については、「DynamoDB での式の使用」を参照してください。
さらに、DynamoDB では、1 つの呼び出しでレガシー条件パラメータと式パラメータを混在させることはできません。例えば、AttributesToGet
と ConditionExpression
で Query
オペレーションを呼び出すとエラーになります。
次の表は、これらのレガシーパラメータを引き続きサポートする DynamoDB API オペレーション、および代替として使用が推奨される式パラメータを示しています。このテーブルは、式パラメータを使用するようにアプリケーションを更新することを検討している場合に役立ちます。
この API オペレーションを使用すると... | これらのレガシーパラメータでは… | 代わりにこの式パラメータを使用 |
---|---|---|
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 |
以下のセクションでは、レガシー条件パラメータについて詳しく説明します。