PartiQL-Delete-Anweisungen für DynamoDB

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 FROM table 
 WHERE condition [RETURNING returnvalues]
 <returnvalues>  ::= ALL OLD *

Parameter

Tabelle

(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"
            }
        }
    ]
}