DynamoDB Transactions:複数アイテムへのオールオアナッシングな書き込み
DynamoDB トランザクション は複数の書き込みを単一の all-or-nothing 操作にまとめます。すべてのアクションがコミットされるか、1 つもコミットされないかのどちらかです。書き込みが半分失敗したときに、関連する 2 つのアイテムが食い違わないようにする方法です。
マルチテナント SaaS の追記専用の監査ログを例にとります。テナントのパーティションキーの下にイベントごとに 1 アイテム(PK = TENANT#acme、SK = EVENT#<time>#<id>)を置き、さらにテナントごとに eventCount を保持する COUNTER アイテムを 1 つ置きます。
追加するすべてのイベントは、そのカウンターも増やすべきです。イベントが書き込まれてもカウンターが更新されなければ、あるいはその逆でも、ログとカウントは永遠に食い違います。
DynamoDB はトランザクションをサポートしていますか?
はい。TransactWriteItems と TransactGetItems は、同じアカウントとリージョン内の
1 つ以上のテーブルにまたがる最大 100 個のアクションを、1 つの all-or-nothing リクエストにまとめます。
- 最大 100 アクション、合計 4 MB。 各アクションは異なるアイテムを対象にします。
- アクションは
Put、Update、Delete、ConditionCheckです。ConditionCheckは、トランザクションが書き込まないアイテムについて何かをアサートします。 - コストは 2 倍です。 すべてのアイテムは準備で 1 回、コミットで 1 回の計 2 回書き込まれ、キャンセルされたトランザクションもそのキャパシティを消費します。
- どれか 1 つの失敗でリクエスト全体がキャンセル され、
TransactionCanceledExceptionが返ります。そのCancellationReasonsが、どのアクションがなぜ失敗したかを示します。
問題: 一致しなければならない 2 つの書き込み
新しい監査イベントごとに、テナントの累積カウントも増やしたいとします。2 つの別々の呼び出しとして行うと、その間のどんな失敗もデータを破損させます:
- 新しい
EVENT#…アイテムをPutItem: 成功する。 ADD eventCount 1へUpdateItem: タイムアウトする。
これでログはカウンターが主張するより 1 行多くなります。盲目的にステップ 2 をリトライすると二重カウントのリスクがあり、リトライしないと不整合のままになります。2 つの書き込みは決して結び付けられていなかったので、安全なリカバリはありません。
SQL から来た人なら、両方を BEGIN … COMMIT で包むでしょう。DynamoDB の答えは、両方の書き込みを一緒に運ぶ 単一のトランザクションリクエスト です。
TransactWriteItems の仕組み
AWS 開発者ガイドによれば、TransactWriteItems は最大 100 個の異なるアイテムを対象に "groups up to 100 write actions in a single all-or-nothing
operation" するもので、"the aggregate size of the
items in the transaction cannot exceed 4 MB." とされています。アクションはアトミックに完了し、すべて成功するか、1 つも成功しないかのどちらかです。
1 つのトランザクションで 4 種類のアクションを混在させられます:
Put: アイテムを作成または置換する。Update: 属性を編集する(このカウンターのためのADDを含む)。Delete: キーでアイテムを削除する。ConditionCheck: それ以外では書き込ま ない アイテムについて条件をアサートする(例:「このテナントはまだアクティブである」)。
1 つのトランザクションで同じアイテムを 2 回対象にすることはできない ので、Update が書き込むアイテムに ConditionCheck を置くことはできません。その条件は代わりに Update
自身の ConditionExpression に入れます。
トランザクションはインデックスに対して実行できません。 GSI で見つけたアイテムを変更するには、インデックスを Query してベーステーブルのキーを取得し、そのキーに対してトランザクションを実行します。GSI の読み取りは結果整合性なので、各アクションに条件を付けてください。
グローバルテーブル では、all-or-nothing の保証は呼び出したリージョンでのみ成り立ちます。ほかのレプリカでは、レプリケーション中にトランザクションの一部だけが一時的に見えることがあります。
実例: 追加とカウントをアトミックに
監査ログに戻ります。テナント acme のイベントを追加し、そのカウンターを増やし、テナントが停止されていないことを確認するのは、3 つの異なるアイテムに対する 3 つのアクションを持つ
1 つのトランザクションです:
| action | item | effect | |
|---|---|---|---|
| Put | TENANT#acme | EVENT#2026-06-24T09:14Z#a1 | write the new audit row |
| Update | TENANT#acme | COUNTER | ADD eventCount 1 |
| ConditionCheck | TENANT#acme | PROFILE | status must be "active" |
いずれかの条件が失敗すると、リクエスト全体が TransactionCanceledException でキャンセルされ、どの 書き込みも起きません。ログとカウンターが食い違うことはありません。
各アクションは独自の ConditionExpression を持ちます。Put の
attribute_not_exists(SK) は、リトライがイベントを 2 回書き込むのを防ぎます。
ConditionCheck の #status = :active はテナントがアクティブであることをアサートします。
status は 予約語 なので、ExpressionAttributeNames を経由させます。
リクエスト全体を tx.json として示します:
[
{
"Put": {
"TableName": "audit-log",
"Item": {
"PK": {"S": "TENANT#acme"},
"SK": {"S": "EVENT#2026-06-24T09:14Z#a1"},
"action": {"S": "invoice.export"}
},
"ConditionExpression": "attribute_not_exists(SK)"
}
},
{
"Update": {
"TableName": "audit-log",
"Key": {"PK": {"S": "TENANT#acme"}, "SK": {"S": "COUNTER"}},
"UpdateExpression": "ADD eventCount :one",
"ExpressionAttributeValues": {":one": {"N": "1"}}
}
},
{
"ConditionCheck": {
"TableName": "audit-log",
"Key": {"PK": {"S": "TENANT#acme"}, "SK": {"S": "PROFILE"}},
"ConditionExpression": "#status = :active",
"ExpressionAttributeNames": {"#status": "status"},
"ExpressionAttributeValues": {":active": {"S": "active"}}
}
}
]aws dynamodb transact-write-items --transact-items file://tx.json \
--client-request-token evt-acme-a1クライアントトークン は、不安定な接続でのリトライを安全にします。同じトークンで 10 分以内に繰り返すと、書き込みを再適用することなく成功が返ります(冪等性)。
トークンがない場合、コミット済みのトランザクションのリトライは Put の
ConditionalCheckFailed でキャンセルされます。これは「適用済み」と読んでください。
DynamoDB Expression Builder は、単一の Put、
Update、Delete 向けに、名前と値のマップ付きの 条件式 を構築します。それらのフィールドを TransactItems の対応するアクションにコピーしてください。
ConditionCheck は手で書きます。
TransactionCanceledException を処理する
AWS SDK はこの例外を自動ではリトライしません。その CancellationReasons リストには
TransactItems の順にアクションごとに 1 エントリがあり、各エントリの Code がすべきことを教えてくれます(TransactWriteItems のエラー):
Code | 意味 | すべきこと |
|---|---|---|
None | このアクションは問題なし | 何もしない |
ConditionalCheckFailed | 条件が偽だった | それを答えとして扱う(重複、停止中) |
TransactionConflict | そのアイテムで別の書き込みが進行中 | 指数バックオフでリトライする |
ThrottlingError, ProvisionedThroughputExceeded | キャパシティ不足 | バックオフしてリトライする。スロットリング を参照 |
ValidationError | 書かれたままではリクエストが成功しえない | リクエストを修正する。リトライしない |
ItemCollectionSizeLimitExceeded | LSI のあるテーブルのアイテムコレクションが 10 GB に達した | そのパーティションキー配下のアイテムを削除または縮小するか、LSI のない新しいテーブルに移る(LSI は削除できない)。リトライしない |
try {
await client.send(new TransactWriteItemsCommand({TransactItems: items}));
} catch (err) {
if (err.name !== 'TransactionCanceledException') throw err;
const codes = (err.CancellationReasons ?? []).map((r) => r.Code); // codes[i] is TransactItems[i]
const retryable = ['TransactionConflict', 'ThrottlingError', 'ProvisionedThroughputExceeded'];
if (codes.some((c) => retryable.includes(c))) {
// back off, then send the same request again
}
}DynoTable でやってみる
DynoTable でアイテムの編集をステージしてコミットすると、楽観ロックの条件付きの
TransactWriteItems 呼び出しとして送信されます。編集は、アイテムが編集開始時の値をまだ保持している場合にのみ適用されます。最大 100 件(約 4 MB)までの編集のコミットは、
1 つの all-or-nothing トランザクションです。
それより大きなコミットは、それぞれ最大 100 アイテムの複数のトランザクションとして送られます。そのうち 1 つが失敗すると、それより前のものは適用されたまま残り、残りは試行されずにステージされたまま残り、失敗した編集は解決すべき競合として表示されます。前述のとおり、各トランザクション書き込みのコストは 2 倍です。
つまり、新しいイベント行とカウンターの編集を一緒にステージし、差分をレビューし、SDK コードを一切書かずに両方をアトミックにコミットできます。

落とし穴と次のステップ
- 2 倍のキャパシティを見込んでください。 トランザクション書き込みはプレーンな書き込みの 2 倍の WCU を課金し、キャンセルされた試行も課金されます。たまの整合性が重要なペアには問題ありませんが、すべての書き込みをトランザクションで包むと高くつきます。アトミック性が実際に重要なところで使ってください。
- ストリームレコードはトランザクションを認識しません。 トランザクションの変更は
DynamoDB Streams に段階的に、他の変更と入り混じって届くので、コンシューマーはそのアイテム間のアトミック性や順序を仮定できません。まとめて見るには
TransactGetItemsで読みます。コミットのすべてが見えるか、何も見えないかのどちらかです。 - ホットなカウンターには上限があります。 1 つの
COUNTERアイテムに対する並行トランザクションは、まずTransactionConflictで互いをキャンセルします。次にスループットが頭打ちになります。1 KB 未満のトランザクション書き込みは、パーティションの毎秒 1,000 書き込みユニットのうち 2 ユニットを消費し、ConditionCheckも同じように課金されます。この例の 3 つのアクション(イベント、カウンター、プロフィールのチェック)は 6 ユニットを消費するので、テナントあたり毎秒約 166 トランザクションが上限です。 - それを超えるなら、カウンターをトランザクションから外します。 ストリームコンシューマーがイベントのバッチごとに合計し、バッチごとに 1 回、数秒遅れでカウンターを書き込めます。あるいは、多少のずれが許容できるならプレーンなアトミックカウンター を使い、1 つのテナントがパーティションを超えて成長したら キーをシャーディング します。
トランザクションは「これらの書き込みは一致しなければならない」ためのツールです。イベントが整合性をもって届くようになったら、次の懸念はそれらに反応することで、それを担うのが DynamoDB Streams です。
自分のテーブルに対して複数アイテムの編集をステージし、それらを単一のトランザクションとしてコミットするには、DynoTable をダウンロード してください。


