Usar expressões no DynamoDB - Amazon DynamoDB

Usar expressões no DynamoDB

No Amazon DynamoDB, você pode usar expressões para especificar quais atributos devem ser lidos em um item, gravar dados quando uma condição é atendida, especificar como atualizar um item, definir consultas e filtrar os resultados de uma consulta.

Esta tabela descreve a gramática de expressão básica e os tipos de expressão disponíveis.

Tipo de expressão Descrição
Expressão de projeção Uma expressão de projeção identifica os atributos que você deseja recuperar de um item ao usar operações como GetItem, Query ou Scan.
Expressão de condição Uma expressão de condição determina quais itens devem ser modificados ao usar as operações PutItem, UpdateItem e DeleteItem.
Expressão de atualização Uma expressão de atualização especifica como UpdateItem modificará os atributos de um item. Por exemplo, definindo um valor escalar ou removendo elementos de uma lista ou de um mapa.
Expressão de condição principal Uma expressão de condição principal determina quais itens uma consulta lerá em uma tabela ou índice.
Expressão de filtro Uma expressão de filtro determina quais itens dos resultados de Query devem ser retornados para você. Todos os outros resultados serão descartados.

Para saber mais sobre sintaxe de expressão e mais detalhes sobre cada tipo de expressão, consulte as seções a seguir.

nota

Para fins de compatibilidade com versões anteriores, o DynamoDB também aceita parâmetros condicionais que não usam expressões. Para ter mais informações, consulte Parâmetros condicionais herdados.

Novas aplicações devem usar expressões em vez de parâmetros herdados.