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.

Ausdrücke für Transaktionsbedingungen

Transaktionsbedingungsausdrücke sind in Anforderungszuweisungsvorlagen aller vier Arten von Operationen in TransactWriteItems, nämlich PutItem, DeleteItem, UpdateItem und ConditionCheck verfügbar.

Für PutItem DeleteItemUpdateItem, und ist der Ausdruck für die Transaktionsbedingung optional. Für ConditionCheck ist der Ausdruck für die Transaktionsbedingung erforderlich.

Beispiel 1

Das folgende DeleteItem-Transaktionszuweisungsdokument weist keinen Bedingungsausdruck auf. Infolgedessen wird das Element in DynamoDB gelöscht.

{
   "version": "2018-05-29",
   "operation": "TransactWriteItems",
   "transactItems": [
      {
         "table": "posts",
         "operation": "DeleteItem",
         "key": {
            "id": { "S" : "1" }
         }
      }
   ]
}

Beispiel 2

Das folgende DeleteItem Transaktionszuordnungsdokument enthält einen Ausdruck für eine Transaktionsbedingung, der es ermöglicht, dass der Vorgang nur dann erfolgreich ist, wenn der Autor dieses Beitrags einem bestimmten Namen entspricht.

{
   "version": "2018-05-29",
   "operation": "TransactWriteItems",
   "transactItems": [
      {
         "table": "posts",
         "operation": "DeleteItem",
         "key": {
            "id": { "S" : "1" }
         }
         "condition": {
            "expression": "author = :author",
            "expressionValues": {
               ":author": { "S" : "Chunyan" }
            }
         }
      }
   ]
}

Wenn die Bedingungsprüfung fehlschlägt, führt dies zu TransactionCanceledException, und die Fehlerdetails werden in $ctx.result.cancellationReasons zurückgegeben. Beachten Sie, dass das alte Element in DynamoDB, bei dem die Zustandsprüfung fehlgeschlagen ist, standardmäßig zurückgegeben wird. $ctx.result.cancellationReasons

Angabe einer Bedingung

Die Zuweisungsdokumente der PutItem- UpdateItem- und DeleteItem-Anforderung erlauben das Angeben eines optionalen condition-Abschnitts. Wenn nicht angegeben, wird keine Bedingungsprüfung ausgeführt. Wenn angegeben, muss die Bedingung wahr sein, damit die Operation erfolgreich ausgeführt werden kann. Der ConditionCheck muss einen condition-Abschnitt haben, der angegeben werden soll. Die Bedingung muss erfüllt sein, damit die gesamte Transaktion erfolgreich ist.

Ein condition-Abschnitt weist die folgende Struktur auf:

"condition": {
    "expression": "someExpression",
    "expressionNames": {
        "#foo": "foo"
    },
    "expressionValues": {
        ":bar": ... typed value
    },
    "returnValuesOnConditionCheckFailure": false
}

Die folgenden Felder geben die Bedingung an: