Parâmetros condicionais legados do DynamoDB
Este documento oferece uma visão geral dos parâmetros condicionais herdados no DynamoDB e recomenda o uso dos novos parâmetros de expressão. Ele aborda detalhes sobre determinados parâmetros, como AttributesToGet, AttributeUpdates, ConditionalOperator, Expected, KeyConditions, QueryFilter e ScanFilter, e fornece exemplos de como usar os novos parâmetros de expressão como substitutos.
Importante
Sugerimos que você use os novos parâmetros de expressão, em vez desses parâmetros herdados. Para ter mais informações, consulte Usar expressões no DynamoDB.
Além disso, o DynamoDB não permite combinar parâmetros condicionais herdados e parâmetros de expressão em uma única chamada. Por exemplo, chamar a operação Query
com AttributesToGet
e ConditionExpression
resultará em um erro.
A tabela a seguir mostra as operações de API do DynamoDB que ainda comportam esses parâmetros herdados e quais parâmetros de expressão devem ser usados. Esta tabela pode ser útil se você estiver considerando atualizar os aplicativos para que eles usem os parâmetros de expressão.
Se você usar essa operação de API... | Com estes parâmetros herdados... | Use este parâmetro de expressão em vez disso |
---|---|---|
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 |
As seções a seguir oferecem mais informações sobre os parâmetros condicionais herdados.