遗留条件参数

本文档概述了 DynamoDB 中的遗留条件参数，并建议改用新的表达式参数。其中详细介绍了诸如 AttributesToGet、AttributeUpdates、ConditionalOperator、Expected、KeyConditions、QueryFilter 和 ScanFilter 等参数，并提供了如何使用新的表达式参数作为替换参数的示例。

重要

建议您尽可能使用新的表达式参数，而不是这些遗留参数。有关更多信息，请参阅 在 DynamoDB 中使用表达式。

此外，DynamoDB 不允许在单次调用中混合遗留条件参数和新表达式参数。例如，用 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

以下章节提供遗留条件参数的更多信息。

主题

• AttributesToGet（遗留）
• AttributeUpdates（遗留）
• ConditionalOperator（遗留）
• Expected（遗留）
• KeyConditions（遗留）
• QueryFilter（遗留）
• ScanFilter（遗留）
• 使用遗留参数编写条件