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

# AttributesToGet (舊版)
<a name="LegacyConditionalParameters.AttributesToGet"></a>

**注意**  
我們建議您盡可能使用新的表達式參數，而不要使用舊版參數。如需詳細資訊，請參閱[在 DynamoDB 中使用表達式](Expressions.md)。如需取代此參數之新參數的特定資訊，請參閱 [改用 *ProjectionExpression*](#ProjectionExpression.instead)。

舊版條件式參數 `AttributesToGet` 是一個陣列，包含從 DynamoDB 中擷取的一或多個屬性。如果未提供屬性名稱，則會傳回所有屬性。如果找不到請求的任一屬性，則不會在結果中顯示這些屬性。

`AttributesToGet` 可讓您擷取 List 或 Map 類型的屬性，但無法擷取 List 或 Map 中的個別元素。

請注意，`AttributesToGet` 並不會影響佈建輸送量的耗用。DynamoDB 會根據項目大小判定使用的容量單位數，而不是根據傳回給應用程式的資料量。

## 改用 *ProjectionExpression* - 範例
<a name="ProjectionExpression.instead"></a>

假設要從 *Music* 資料表擷取一個項目，但只想傳回部分屬性。您可以搭配 `AttributesToGet` 參數使用`GetItem`請求，如本 AWS CLI 範例所示：

```
aws dynamodb get-item \
    --table-name Music \
    --attributes-to-get '["Artist", "Genre"]' \
    --key '{
        "Artist": {"S":"No One You Know"},
        "SongTitle": {"S":"Call Me Today"}
    }'
```

您可以改用 `ProjectionExpression`。

```
aws dynamodb get-item \
    --table-name Music \
    --projection-expression "Artist, Genre" \
    --key '{
        "Artist": {"S":"No One You Know"},
        "SongTitle": {"S":"Call Me Today"}
    }'
```