DynamoDB 項目層級動作：GetItem、PutItem、UpdateItem、DeleteItem

DynamoDB 的 API 分成三大類：以單一項目的主鍵進行操作的項目層級動作、在單一 partition 內讀取一段範圍的 Query，以及讀取所有內容的 Scan。本指南介紹第一類 — 你最常用的四個操作：GetItem、PutItem、UpdateItem、DeleteItem。它們是 DynamoDB 提供的最便宜、最快速的呼叫，而正確掌握它們之間的差異（尤其是 Put 與 Update）能避免一整類意外資料遺失的 bug。

什麼是 DynamoDB 的項目層級操作？

DynamoDB 的項目層級操作，是以完整主鍵對單一項目進行操作的四個呼叫：GetItem 讀取項目、PutItem 建立或完全取代項目、UpdateItem 就地修改特定屬性，而 DeleteItem 移除項目。每一個都精確地處理剛好一個項目，使它們成為最快速、最便宜的呼叫 — 不像 Query 與 Scan 會讀取許多項目。

GetItem — 以完整主鍵讀取一個項目。
PutItem — 建立或完全取代一個項目。
UpdateItem — 建立或就地修改一個項目的特定屬性。
DeleteItem — 以完整主鍵移除一個項目。
這四者都需要完整的主鍵（partition key，若表格有 sort key 則還需 sort key） — 它們精確地定位剛好一個項目。
PutItem 會覆寫整個項目；UpdateItem 則是外科手術式的 — 把兩者搞混，正是屬性默默消失的原因。

決定性特徵：一個項目、完整的鍵

每個項目層級動作都以完整主鍵鎖定單一項目。這正是它們又快又便宜的原因 — DynamoDB 對 partition key 做雜湊，直接找到該項目，完成。沒有篩選、沒有掃描。如果你不知道完整的鍵，這些就不是對的工具；那是 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）。