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 FROMtableWHEREcondition[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
returnvaluesse 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"
}
}
]
}