本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

條件表達式

當您使用 PutItem、 UpdateItem和 DynamoDB 操作來變更 DeleteItem DynamoDB 中的物件時，您可以選擇指定條件表達式，以根據在執行操作之前在 DynamoDB 中已存在的物件狀態來控制請求是否成功。

The AWS AppSync DynamoDB 解析程式允許在 PutItem、 中指定條件表達式UpdateItem，並DeleteItem請求映射文件，以及如果條件失敗且未更新物件時要遵循的策略。

範例 1

以下 PutItem 映射文件沒有條件表達式。因此，即使具有相同索引鍵的項目已存在，也會將項目放入 DynamoDB，藉此覆寫現有項目。

{
   "version" : "2017-02-28",
   "operation" : "PutItem",
   "key" : {
      "id" : { "S" : "1" }
   }
}

範例 2

下列PutItem映射文件確實具有條件表達式，只有在 DynamoDB 中不存在具有相同索引鍵的項目時，才會允許操作成功。

{
   "version" : "2017-02-28",
   "operation" : "PutItem",
   "key" : {
      "id" : { "S" : "1" }
   },
   "condition" : {
      "expression" : "attribute_not_exists(id)"
   }
}

根據預設，如果條件檢查失敗， AWS AppSync DynamoDB 解析程式會傳回變動的錯誤。不過， AWS AppSync DynamoDB 解析程式提供一些額外的功能，以協助開發人員處理一些常見的邊緣案例：

處理條件檢查失敗一節將更詳細地說明這些內容。

如需 DynamoDB 條件表達式的詳細資訊，請參閱 DynamoDB ConditionExpressions 文件。

指定條件

PutItem、UpdateItem 和 DeleteItem 要求映射文件都允許可指定選用的 condition 區段。若省略，則不會有條件檢查。若指定，條件必須為 true，操作才會成功。

condition 區段的結構如下：

"condition" : {
    "expression" : "someExpression"
    "expressionNames" : {
        "#foo" : "foo"
    },
    "expressionValues" : {
        ":bar" : ... typed value
    },
    "equalsIgnore" : [ "version" ],
    "consistentRead" : true,
    "conditionalCheckFailedHandler" : {
        "strategy" : "Custom",
        "lambdaArn" : "arn:..."
    }
}

下列欄位指定條件：

其餘欄位會告知 AWS AppSync DynamoDB 解析程式如何處理條件檢查失敗：

處理條件檢查失敗

根據預設，當條件檢查失敗時， AWS AppSync DynamoDB 解析程式會傳回 DynamoDB 中物件的變動和目前值的錯誤。不過， AWS AppSync DynamoDB 解析程式提供一些額外的功能，以協助開發人員處理一些常見的邊緣案例：

此程序的流程圖為：

檢查所需結果

當條件檢查失敗時， AWS AppSync DynamoDB 解析程式會執行 GetItem DynamoDB 請求，從 DynamoDB 取得項目的目前值。在預設情況下，它會使用強式一致性讀取，但這可使用 condition 區塊中的 consistentRead 欄位來設定，並和預期結果進行比較：

如果 DynamoDB 中物件的目前狀態與預期結果不同， AWS AppSync DynamoDB 解析程式會遵循已設定的策略，以拒絕變動或叫用 Lambda 函數來決定下一步該怎麼做。

遵循「拒絕」策略

遵循Reject策略時， AWS AppSync DynamoDB 解析程式會傳回變動的錯誤。

例如，假設變動要求如下：

mutation {
    updatePerson(id: 1, name: "Steve", expectedVersion: 1) {
        Name
        theVersion
    }
}

如果 DynamoDB 傳回的項目如下所示：

{
   "id" : { "S" : "1" },
   "name" : { "S" : "Steve" },
   "version" : { "N" : 8 }
}

而回應映射範本如下所示：

{
   "id" : $util.toJson($context.result.id),
   "Name" : $util.toJson($context.result.name),
   "theVersion" : $util.toJson($context.result.version)
}

GraphQL 回應的外觀如下所示：

{
  "data": null,
  "errors": [
    {
      "message": "The conditional request failed (Service: AmazonDynamoDBv2; Status Code: 400; Error Code: ConditionalCheckFailedException; Request ID: ABCDEFGHIJKLMNOPQRSTUVWXYZABCDEFGHIJKLMNOPQRSTUVWXYZ)"
      "errorType": "DynamoDB:ConditionalCheckFailedException",
      ...
    }
  ]
}

此外，如果傳回物件中的任何欄位皆由其他解析程式填入，且變動成功，則在 error 區段中傳回物件時，不會解析這些物件。

遵循「自訂」策略

遵循Custom策略時， AWS AppSync DynamoDB 解析程式會叫用 Lambda 函數來決定接下來要做什麼。Lambda 函數會選擇下列其中一個選項：

Lambda 叫用要求

The AWS AppSync DynamoDB 解析程式會叫用 中指定的 Lambda 函數lambdaArn。它會使用資料來源上所設定的相同 service-role-arn。叫用承載的結構如下：

{
    "arguments": { ... },
    "requestMapping": {... },
    "currentValue": { ... },
    "resolver": { ... },
    "identity": { ... }
}

欄位定義如下：

承載的完整範例：

{
    "arguments": {
        "id": "1",
        "name": "Steve",
        "expectedVersion": 1
    },
    "requestMapping": {
        "version" : "2017-02-28",
        "operation" : "PutItem",
        "key" : {
           "id" : { "S" : "1" }
        },
        "attributeValues" : {
           "name" : { "S" : "Steve" },
           "version" : { "N" : 2 }
        },
        "condition" : {
           "expression" : "version = :expectedVersion",
           "expressionValues" : {
               ":expectedVersion" : { "N" : 1 }
           },
           "equalsIgnore": [ "version" ]
        }
    },
    "currentValue": {
        "id" : { "S" : "1" },
        "name" : { "S" : "Steve" },
        "version" : { "N" : 8 }
    },
    "resolver": {
        "tableName": "People",
        "awsRegion": "us-west-2",
        "parentType": "Mutation",
        "field": "updatePerson",
        "outputType": "Person"
    },
    "identity": {
        "accountId": "123456789012",
        "sourceIp": "x.x.x.x",
        "user": "AIDAAAAAAAAAAAAAAAAAA",
        "userArn": "arn:aws:iam::123456789012:user/appsync"
    }
}

Lambda 叫用回應

Lambda 函數可以檢查調用承載，並套用任何商業邏輯，以決定 AWS AppSync DynamoDB 解析程式應如何處理故障。處理條件檢查失敗有三個選項：

此為 Lambda 函數處理失敗 PutItem 要求的範例。商業邏輯的重點是發起人為何。如果是由 提出jeffTheAdmin，則會重試請求，expectedVersion並從目前 DynamoDB 中的項目更新 version和 。否則，它會拒絕變動。

exports.handler = (event, context, callback) => {
    console.log("Event: "+ JSON.stringify(event));

    // Business logic goes here.

    var response;
    if ( event.identity.user == "jeffTheAdmin" ) {
        response = {
            "action" : "retry",
            "retryMapping" : {
                "attributeValues" : event.requestMapping.attributeValues,
                "condition" : {
                    "expression" : event.requestMapping.condition.expression,
                    "expressionValues" : event.requestMapping.condition.expressionValues
                }
            }
        }
        response.retryMapping.attributeValues.version = { "N" : event.currentValue.version.N + 1 }
        response.retryMapping.condition.expressionValues[':expectedVersion'] = event.currentValue.version

    } else {
        response = { "action" : "reject" }
    }

    console.log("Response: "+ JSON.stringify(response))
    callback(null, response)
};