本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 舊版 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)