Python（boto3）中的 DynamoDB 条件写入

条件写入会给 put_item、update_item 或 delete_item 附加一个 ConditionExpression：DynamoDB 会针对当前项目对它求值，仅在成立时才应用该写入——原子地进行，没有读-改-写竞态。这是 DynamoDB 的乐观锁原语。本示例用一次版本检查来保护一次更新。

Code

import boto3

client = boto3.client("dynamodb")

# Update the item only if nobody changed it since we read version 7.
try:
    client.update_item(
        TableName="Music",
        Key={"Artist": {"S": "Arturo Sandoval"}, "SongTitle": {"S": "Cubano Chant"}},
        UpdateExpression="SET #upd0 = :updValue0, #version = :newVersion",
        ConditionExpression="attribute_exists(#cond0) AND #version = :expectedVersion",
        ExpressionAttributeNames={"#upd0": "Genre", "#version": "Version", "#cond0": "Artist"},
        ExpressionAttributeValues={
            ":updValue0": {"S": "Latin Jazz"},
            ":expectedVersion": {"N": "7"},
            ":newVersion": {"N": "8"},
        },
        ReturnValuesOnConditionCheckFailure="ALL_OLD",
    )
    print("Updated to version 8")
except client.exceptions.ConditionalCheckFailedException as e:
    # With ReturnValuesOnConditionCheckFailure="ALL_OLD", the current item
    # rides back on the exception — no extra read to see what beat you.
    print("Lost the race — item is now:", e.response.get("Item"))

说明

ConditionExpression — 与写入原子地一起针对已存储项目进行检查。可用函数：attribute_exists、attribute_not_exists、attribute_type、contains、begins_with、size，外加比较符（=、<>、<、>、<=、>=、BETWEEN、IN）以及 AND/OR/NOT。
两个主力惯用法：
- 在更新上使用 attribute_exists(#key) = "仅更新，绝不创建"。没有它，对缺失键的 update_item 会静默地创建该项目（意外的 upsert bug）。
- 在put上使用 attribute_not_exists(#key) = "仅创建，绝不覆盖"——见 PutItem 页面。
乐观锁 — 读取项目（版本 7），然后在把版本提升到 8 的同时以 #version = :expectedVersion 写入。两个并发写入者不可能同时获胜；失败者会得到 ConditionalCheckFailedException，随后重新读取并基于新版本重试。
ReturnValuesOnConditionCheckFailure="ALL_OLD" — 把当前项目放在异常响应上（e.response），省去失败检查后再做一次 get_item。它不消耗读取容量；失败的条件写入仍会对该次写入尝试计费。
在 resource API 上，同样的保护写作 table.update_item(..., ConditionExpression=Attr("Version").eq(7) & Attr("Artist").exists())，使用原生 Python 值。

可视化操作

条件表达式正是 DynamoDB Expression Builder 所构建的——选择函数，即可获得表达式外加名称/值映射，作为可运行的 boto3 代码。

想用生成的、可审阅的表达式来编辑项目，而不是手打的占位符——请下载 DynoTable。

References

Last verified 2026-07-13 against the official AWS documentation linked above.

Python（boto3）中的 DynamoDB 条件写入

Code

说明

可视化操作

相关示例

References