Instruções Delete em PartiQL para DynamoDB
Use a instrução DELETE
para excluir um item existente da tabela do Amazon DynamoDB.
nota
É possível excluir apenas um item de cada vez. Você não pode emitir uma única instrução PartiQL do DynamoDB para excluir vários itens. Para obter informações sobre como excluir vários itens, consulte Executar transações com PartiQL para DynamoDB ou Executar operações em lote com PartiQL para DynamoDB.
Sintaxe
DELETE FROM
table
WHEREcondition
[RETURNINGreturnvalues
] <returnvalues> ::= ALL OLD *
Parâmetros
tabela
-
(Obrigatório) A tabela do DynamoDB que contém o item a ser excluído.
condição
-
(Obrigatório) Os critérios de seleção para o item a ser excluído; essa condição deve ser resolvida para um único valor de chave primária.
returnvalues
-
(Opcional) Use
returnvalues
se desejar obter os atributos do item como eles apareciam antes de ser excluídos. Os valores válidos são:-
ALL OLD *
: o conteúdo do item antigo é retornado.
-
Valor de retorno
Esta instrução não retornará um valor a menos que o parâmetro returnvalues
seja especificado.
nota
Se a tabela do DynamoDB não tiver nenhum item com a mesma chave primária que a do item para o qual a instrução DELETE foi emitida, SUCESS será retornado com 0 itens excluídos. Se a tabela tiver um item com a mesma chave primária, mas a condição na cláusula WHERE da instrução DELETE for avaliada como false, ConditionalCheckFailedException
será retornado.
Exemplos
A consulta a seguir exclui um item da tabela "Music"
.
DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks'
Você pode adicionar o parâmetro RETURNING ALL OLD *
para retornar os dados que foram excluídos.
DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks' RETURNING ALL OLD *
A instrução Delete
agora retorna o seguinte:
{ "Items": [ { "Artist": { "S": "Acme Band" }, "SongTitle": { "S": "PartiQL Rocks" } } ] }