PHP操作DynamoDB：向嵌套列表添加/更新邮箱地址问题

数据表结构及示例数据 #

ID: STRING
DEP: MAP
    Contacts: MAP
        EMAIL: LIST
Version: Number

示例条目：

{
  "ID": "1234567888",
  "Dep": {
    "Contacts": {
      "Email": [
        "test@test.com"
      ]
    }
  },
  "Version": 34
}

当前问题 #

你现在用SET直接赋值的方式会覆盖原有邮箱列表，无法实现追加。下面提供两种解决方案：

方案1：基础追加（不做去重） #

使用DynamoDB的list_append函数，将新邮箱追加到原有列表末尾。修改后的代码如下：

$eav = $marshaler->marshalItem([":email" => [$email]]);
$params = [
    'TableName' => "xxx",
    'Key' => ['ID' => ['S' => $key]],
    'UpdateExpression' => 'SET Dep.Contacts.Email = list_append(Dep.Contacts.Email, :email)',
    'ExpressionAttributeValues' => $eav,
    'ReturnValues' => 'UPDATED_NEW'
];
$result = $dynamodb->updateItem($params);

注意：list_append的两个参数都必须是列表，所以:email要传包含单个邮箱的数组。另外Key参数需符合DynamoDB格式，要指定数据类型（比如'S'代表字符串）。

方案2：追加且去重（仅当邮箱不存在时添加） #

通过ConditionExpression判断目标邮箱不在现有列表中，再执行追加操作：

// 同时传递单个邮箱（用于条件判断）和邮箱列表（用于追加）
$eav = $marshaler->marshalItem([
    ":email" => [$email],
    ":single_email" => $email
]);
$params = [
    'TableName' => "xxx",
    'Key' => ['ID' => ['S' => $key]],
    'UpdateExpression' => 'SET Dep.Contacts.Email = list_append(Dep.Contacts.Email, :email)',
    'ConditionExpression' => 'NOT contains(Dep.Contacts.Email, :single_email)',
    'ExpressionAttributeValues' => $eav,
    'ReturnValues' => 'UPDATED_NEW'
];
try {
    $result = $dynamodb->updateItem($params);
    echo "邮箱追加成功";
} catch (\Aws\DynamoDb\Exception\DynamoDbException $e) {
    if ($e->getAwsErrorCode() === 'ConditionalCheckFailedException') {
        echo "该邮箱已存在，无需重复添加";
    } else {
        // 处理其他异常
        echo "更新失败：" . $e->getMessage();
    }
}

这里利用contains函数检查列表中是否存在目标邮箱，NOT取反后作为执行更新的前置条件。如果邮箱已存在，会抛出ConditionalCheckFailedException，可捕获该异常做对应处理。

内容的提问来源于stack exchange，提问作者cpat431