AttributesToGet （舊版）

注意

我們建議您盡可能使用新的表達式參數，而不要使用舊版參數。如需詳細資訊，請參閱在 DynamoDB 中使用表達式。如需取代此參數之新參數的特定資訊，請參閱 ProjectionExpression 改為使用。

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

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

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

請ProjectionExpression改用 - 範例

假設要從 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"}
    }'