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 
 WHERE condition [RETURNING returnvalues]
 <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"
            }
        }
    ]
}