Istruzioni DELETE PartiQL per DynamoDB

Utilizza l'istruzione DELETE per eliminare un elemento esistente dalla tabella Amazon DynamoDB.

Nota

È possibile eliminare un solo elemento alla volta. Non è possibile emettere una singola istruzione DynamoDB PartiQL che elimina più elementi. Per informazioni sull'aggiornamento di più elementi, consulta Esecuzione di transazioni con PartiQL per DynamoDB o Esecuzione di operazioni in batch con PartiQL per DynamoDB.

Sintassi

DELETE FROM table 
 WHERE condition [RETURNING returnvalues]
 <returnvalues>  ::= ALL OLD *

Parametri

tabella

(Obbligatorio) La tabella DynamoDB contenente l'elemento da eliminare.

condizione

(Obbligatorio) I criteri di selezione per l'elemento da eliminare. Questa condizione deve essere risolta in un singolo valore di chiave primaria.

returnvalues

(Facoltativo) Utilizza returnvalues se desideri ottenere gli attributi dell'elemento come apparivano prima dell'eliminazione. I valori validi sono:

• ALL OLD *: viene restituito il contenuto del vecchio elemento.

Valore restituito

Questa istruzione non restituisce un valore a meno che non sia stato specificato il parametro returnvalues.

Nota

Se la tabella DynamoDB non dispone di alcun elemento con la stessa chiave primaria di quella dell'elemento per il quale viene emessa l'istruzione DELETE (ELIMINA), viene restituito SUCCESS (ESITO POSITIVO) con 0 elementi eliminati. Se la tabella ha un elemento con la stessa chiave primaria, ma la condizione nella clausola WHERE (DOVE) dell'istruzione DELETE (ELIMINA) restituisce valore false, viene restituito il parametro ConditionalCheckFailedException.

Esempi

La query seguente elimina un elemento nella tabella "Music".

DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks'

È possibile aggiungere il parametro RETURNING ALL OLD * per restituire i dati che sono stati eliminati.

DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks' RETURNING ALL OLD *

L'istruzione Delete ora restituisce quanto segue:

{
    "Items": [
        {
            "Artist": {
                "S": "Acme Band"
            },
            "SongTitle": {
                "S": "PartiQL Rocks"
            }
        }
    ]
}