AttributesToGet (herdado)
nota
Sugerimos que você use os novos parâmetros de expressão, em vez desses parâmetros herdados. Para ter mais informações, consulte Usar expressões no DynamoDB. Para obter informações específicas sobre o novo parâmetro que substitui este, Use ProjectionExpression em vez disso.
O parâmetro condicional herdado AttributesToGet
é um conjunto de um ou mais atributos a serem recuperados do DynamoDB. Se os nomes de atributo não forem fornecidos, todos os atributos serão retornados. Se qualquer um dos atributos solicitados não for encontrado, ele não aparecerá no resultado.
AttributesToGet
permite que você recupere atributos do tipo List ou Map; no entanto, ele não pode recuperar elementos individuais em uma lista ou um mapa.
Observe que AttributesToGet
não afeta o consumo de throughput provisionado. O DynamoDB determina as unidades de capacidade consumidas com base no tamanho do item, e não na quantidade de dados que são retornados para um aplicativo.
Use ProjectionExpression em vez disso: exemplo
Suponha que você quisesse recuperar um item da tabela Music, mas desejasse retornar somente alguns dos atributos. Você poderia usar uma solicitação GetItem
com um parâmetro AttributesToGet
, como neste exemplo da 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"} }'
Você pode usar ProjectionExpression
em vez disso:
aws dynamodb get-item \ --table-name Music \ --projection-expression "Artist, Genre" \ --key '{ "Artist": {"S":"No One You Know"}, "SongTitle": {"S":"Call Me Today"} }'