AttributesToGet (レガシー)

レガシー条件パラメータ AttributesToGet は、DynamoDB から取得する 1 つ以上の属性の配列です。属性名が指定されていない場合、すべての属性が返されます。リクエストした属性が見つからない場合、その属性は結果に表示されません。

AttributesToGet では、リストまたはマップ型の属性を取得できますが、リストまたはマップ内の個々の要素を取得することはできません。

AttributesToGet は、プロビジョニングされたスループットの消費には影響しません。DynamoDB は、アプリケーションに返されるデータ量ではなく、項目のサイズに基づいて、消費される読み込み容量ユニットの数を決定します。

代わりに ProjectionExpression を使用 - 例

Music テーブルから項目を取得する際、一部の属性のみが返されるようにする場合を考えてみます。次の AWS CLI の例に示すように、AttributesToGet パラメータを含む GetItem リクエストを使用できます。

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"}
    }'