Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Verwenden derDELETE-Anweisung verwenden, um ein vorhandenes Element aus Ihrer Amazon-DynamoDB-Tabelle zu löschen.
Anmerkung
Sie können nur jeweils ein Element löschen. Sie können keine einzelne DynamoDB-PartiQL-Anweisung ausgeben, die mehrere Elemente löscht. Informationen zum Löschen mehrerer Elemente finden Sie unter Ausführen von Transaktionen mit PartiQL für DynamoDB oder Ausführen von Batchoperationen mit PartiQL für DynamoDB.
Syntax
DELETE FROMtableWHEREcondition[RETURNINGreturnvalues] <returnvalues> ::= ALL OLD *
Parameter
table-
(Erforderlich) Die DynamoDB-Tabelle, die das zu löschende Element enthält.
condition-
(Erforderlich) Die Auswahlkriterien für das zu löschende Element; diese Bedingung muss auf einen einzelnen Primärschlüsselwert aufgelöst werden.
returnvalues-
(Optional) Verwenden Sie
returnvalues, wenn Sie die Elementattribute so erhalten möchten, wie sie vor dem Löschen dargestellt wurden. Die gültigen Werte sind:-
ALL OLD *- die Inhalte des alten Elements werden zurückgegeben.
-
Rückgabewert
Diese Anweisung gibt keinen Wert zurück, es sei denn der returnvalues-Parameter ist angegeben.
Anmerkung
Wenn in der DynamoDB-Tabelle kein Element mit demselben Primärschlüssel wie dem des Elements vorhanden ist, für das das DELETE ausgegeben wird, wird SUCCESS zurückgegeben, wobei 0 Elemente gelöscht wurden. Wenn die Tabelle ein Element mit demselben Primärschlüssel enthält, aber die Bedingung in der WHERE-Klausel der DELETE-Anweisung als falsch ausgewertet wird, wird ConditionalCheckFailedException zurückgegeben.
Beispiele
Mit der folgenden Abfrage wird ein Element in der Tabelle "Music" gelöscht.
DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks'Sie können den Parameter RETURNING ALL OLD * hinzufügen, um die gelöschten Daten zurückzugeben.
DELETE FROM "Music" WHERE "Artist" = 'Acme Band' AND "SongTitle" = 'PartiQL Rocks' RETURNING ALL OLD *Die Delete-Anweisung gibt nun Folgendes zurück:
{
"Items": [
{
"Artist": {
"S": "Acme Band"
},
"SongTitle": {
"S": "PartiQL Rocks"
}
}
]
}