Instructions de suppression de PartiQL pour DynamoDB

Utilisez l'instruction DELETE pour supprimer un élément existant de votre table Amazon DynamoDB.

Note

Vous ne pouvez supprimer qu'un seul élément à la fois. Vous ne pouvez pas émettre une seule instruction PartiQL pour DynamoDB qui supprime plusieurs éléments. Pour plus d'informations sur la suppression de plusieurs éléments, consultez Exécution de transactions avec PartiQL pour DynamoDB ou Exécution d'opérations par lot avec PartiQL pour DynamoDB.

Syntaxe

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

Paramètres

table

(Obligatoire) Table DynamoDB contenant l'élément à supprimer.

condition

(Obligatoire) Critères de sélection de l'élément à supprimer. Le résultat de cette condition doit être une seule valeur de clé primaire.

returnvalues

(Facultatif) Utilisez returnvalues si vous souhaitez obtenir les attributs de l'élément avant sa suppression. Les valeurs valides sont :

• ALL OLD * – Le contenu de l'ancien élément est renvoyé.

Valeur renvoyée

Cette instruction ne renvoie de valeur que si le paramètre returnvalues est spécifié.

Note

Si la table DynamoDB ne contient aucun élément dont la même clé primaire est la même que celle de l'élément pour lequel l'instruction DELETE est émise, le résultat SUCCESS est renvoyé avec 0 élément supprimé. Si la table contient un élément avec la même clé primaire, mais que le résultat de la condition dans la clause WHERE de l'instruction DELETE est false (faux), l'erreur ConditionalCheckFailedException est renvoyée.

Exemples

La requête suivante interroge un élément dans la table "Music".

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

Vous pouvez ajouter le paramètre RETURNING ALL OLD * pour renvoyer les données supprimées.

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

L'instruction Delete renvoie désormais ce qui suit :

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