使用boto3更新DynamoDB表指定主键对应item属性的正确语法是什么？

报错原因说明 #

• AttributeUpdates参数类型错误：该参数要求每个待更新字段都必须传入包含Action和Value的嵌套字典结构，直接传入字段值字符串会触发类型校验失败
• 关键字参数报错：update_item方法要求所有入参必须以关键字参数形式传递，不能将参数打包为单个位置字典直接传入

官方推荐写法（UpdateExpression） #

该写法为当前AWS官方推荐的更新语法，只会修改指定字段，其余已有字段会完全保留，不会触发删除后重插逻辑，以下为Python boto3示例：

import boto3

# 初始化DynamoDB表实例
dynamodb = boto3.resource('dynamodb')
table = dynamodb.Table('替换为你的表名')

update_resp = table.update_item(
    # 指定要更新的主键
    Key={
        'filename': '替换为要更新的文件名主键值'
    },
    # 指定更新动作，多个字段用英文逗号分隔
    UpdateExpression='SET file_size = :size_val, upload_status = :status_val',
    # 绑定表达式中占位符的实际值
    ExpressionAttributeValues={
        ':size_val': 2048,
        ':status_val': 'uploaded'
    },
    # 可选配置：仅当该主键条目存在时才执行更新，避免误新增不存在的条目
    ConditionExpression='attribute_exists(filename)'
)

旧版AttributeUpdates正确写法（不推荐） #

如果你需要兼容旧代码，以下为AttributeUpdates参数的正确写法：

update_resp = table.update_item(
    Key={
        'filename': '替换为要更新的文件名主键值'
    },
    AttributeUpdates={
        'file_size': {
            'Value': 2048,
            'Action': 'PUT'
        },
        'upload_status': {
            'Value': 'uploaded',
            'Action': 'PUT'
        }
    }
)

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