DynamoDB 基于项的操作：GetItem、PutItem、UpdateItem、DeleteItem

DynamoDB 的 API 分为三大类：基于项的操作，按主键作用于单个项；Query，读取一个分区内的一段范围；以及 Scan，读取所有内容。本指南讲第一类——你用得最多的四个操作： GetItem、PutItem、UpdateItem、DeleteItem。它们是 DynamoDB 提供的最便宜、最快的调用，而把它们的区分搞对（尤其是 Put 与 Update）能避免一整类意外丢数据的 bug。

什么是 DynamoDB 基于项的操作？

DynamoDB 基于项的操作，是按完整主键作用于单个项的那四个调用：GetItem 读取它，PutItem 创建或完全替换它，UpdateItem 原地修改指定属性，DeleteItem 删除它。每个操作都恰好针对一个项，因而是最快、最便宜的调用——不同于一次读取多项的 Query 和 Scan。

GetItem —— 按完整主键读取一个项。
PutItem —— 创建或完全替换一个项。
UpdateItem —— 创建或原地修改某个项的指定属性。
DeleteItem —— 按完整主键删除一个项。
这四个都需要完整主键（分区键，若表有排序键还需排序键）—— 它们精确定位到恰好一个项。
PutItem 覆盖整个项；UpdateItem 是外科手术式的 —— 把它们搞混，属性就会悄悄消失。

决定性特征：一个项，完整键

每个基于项的操作都按完整主键定位单个项。这正是它们快且便宜的原因 —— DynamoDB 对分区键做哈希，直奔那个项，完事。没有过滤，没有扫描。如果你不知道完整键，这些就不是合适的工具；那是 Query 和 Scan 的用武之地。

假设你管理以 USER#<id> 为键的用户账户：

PK: USER#204   email, displayName, plan, createdAt

对 USER#204 执行 GetItem → 直接得到那个用户。
对 USER#204 执行 DeleteItem → 删除那个用户。

两者都需要确切的键。没有键，就没有基于项的操作。

`PutItem` 与 `UpdateItem` —— 会咬人的那个

这个区分值得牢牢记住：

PutItem 写入整个项。 如果 USER#204 已存在，而你用仅含 {email, displayName} 的 PutItem，那么现有的 plan 和 createdAt 属性就没了 —— put 替换整个项，它不合并。
UpdateItem 只改你指定的内容。 带 SET email = … 的 UpdateItem 会保持其他所有属性不变，并在项不存在时创建它（一次 upsert）。