AttributesToGet (hérité)

Note

Dans la mesure du possible, nous vous recommandons d'utiliser les nouveaux paramètres d'expression plutôt que ces paramètres hérités. Pour de plus amples informations, veuillez consulter Utilisation d'expressions dans DynamoDB. Pour obtenir des informations précises sur le nouveau paramètre qui remplace celui-ci, utilisez ProjectionExpression à la place..

Le paramètre conditionnel hérité AttributesToGet est un tableau d'un ou plusieurs attributs à extraire de DynamoDB. Si aucun nom d'attribut n'est fourni, tous les attributs sont renvoyés. Les attributs demandés non trouvés n'apparaissent pas dans le résultat.

AttributesToGet vous permet d'extraire des attributs de type liste ou mappage, mais pas des éléments individuels d'une liste ou d'un mappage.

Notez qu'AttributesToGet n'a aucun effet sur la consommation du débit approvisionné. DynamoDB détermine les unités de capacité consommées sur la base de la taille d'un élément, pas de la quantité de données qu'il renvoie à une application.

Utiliser ProjectionExpression à la place – Exemple

Supposons que vous souhaitez extraire un élément de la table Music, mais ne voulez renvoyer que certains des attributs. Vous pourriez utiliser une requête GetItem avec un paramètre AttributesToGet comme dans cet exemple d'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"}
    }'

Vous pouvez utiliser ProjectionExpression à la place :

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