# 遗留 DynamoDB 条件参数
<a name="LegacyConditionalParameters"></a>

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

**重要**  
建议您尽可能使用新的表达式参数，而不是这些遗留参数。有关更多信息，请参阅 [在 DynamoDB 中使用表达式](Expressions.md)。  
此外，DynamoDB 不允许在单次调用中混合遗留条件参数和新表达式参数。例如，用 `AttributesToGet` 和 `ConditionExpression` 调用 `Query` 操作将导致错误。

下表显示仍支持这些遗留参数的 DynamoDB 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



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

**Topics**
+ [AttributesToGet（遗留）](LegacyConditionalParameters.AttributesToGet.md)
+ [AttributeUpdates（遗留）](LegacyConditionalParameters.AttributeUpdates.md)
+ [ConditionalOperator（遗留）](LegacyConditionalParameters.ConditionalOperator.md)
+ [Expected（遗留）](LegacyConditionalParameters.Expected.md)
+ [KeyConditions（遗留）](LegacyConditionalParameters.KeyConditions.md)
+ [QueryFilter（遗留）](LegacyConditionalParameters.QueryFilter.md)
+ [ScanFilter（遗留）](LegacyConditionalParameters.ScanFilter.md)
+ [使用遗留参数编写条件](LegacyConditionalParameters.Conditions.md)