テーマ別の解説テーマ:イベント駆動処理の設計
冪等性とは?再試行で二重処理を防ぐ設計
同じ依頼を何度受けても、業務上の結果を一度分に保つ性質を冪等性と呼びます。 画像変換の受付を例に、処理が成功した直後に応答を失うとき、依頼IDと保存結果を使って再試行に応じる流れを学びます。
依頼IDを再利用する範囲を説明し、重複・内容の衝突・成否不明を区別して、受付記録と副作用をどこで確定するか判断できる。
SQSではメッセージが再配信される場合があります。ここでは受付行を保存する架空のサービスを使い、実AWSやDBへの接続なしで確認します。
応答が消えても、保存が取り消されるとは限らない
依頼を送った側がタイムアウトしても、受け取った側で処理が始まっていない場合と、結果がすでに保存された場合があります。再試行の可否を、応答を受け取れたかどうかだけで決めると、同じ結果を二重に作る恐れがあります。
- 依頼元 → 画像変換の受付img-42 を送信
- 画像変換の受付 → 受付データベース初回に1件を保存
- 受付データベース → 再試行した依頼元受付が同じ結果を返す
- 依頼元
- 依頼ID img-42 を保持
- 画像変換の受付
- 依頼IDと内容を照合
- 受付データベース
- 受付行と結果IDを確定
- 再試行した依頼元
- 同じ結果ID J-81 を受け取る
依頼IDは送信側が意図した作業の単位です。同じ操作を再送するときは同じIDを使い、同じ画像でも別の変換を新たに依頼するときは新しいIDを使います。画像の内容だけで依頼をまとめると、正当な二度目の依頼まで失う場合があります。
依頼IDの範囲と、再試行時の応答を決める
{
"requestId": "img-42",
"image": "sample.png",
"width": 640
}| 受け取った内容 | 保存記録との照合 | 受付側の判断 |
|---|---|---|
| A / img-42 / 幅640 | 同じ依頼元、ID、内容 | J-81 を返す。受付行は増やさない。 |
| A / img-42 / 幅320 | 同じ依頼元とID、異なる内容 | 内容の衝突を返す。元の受付を上書きしない。 |
| A / img-43 / 幅640 | 同じ内容、別の依頼ID | 新しい依頼として審査する。 |
| B / img-42 / 幅640 | 別の依頼元 | Bの権限とIDの範囲で照合する。Aの結果は返さない。 |
記録が有効な間は、同じIDと内容から保存済みの結果を返せます。保持期限は再試行・再配信・手動再処理を許す期間に合わせて決めます。期限の外で遅れて届いた依頼を受ける場合は、古い依頼の扱いを別途定めます。
受付行を保存する操作と、その記録の境界を合わせる
受付データベースに保存する副作用なら、依頼元と依頼IDの組に一意制約を設け、受付行と結果の記録を同じトランザクションで確定する設計を検討できます。同時に届いた二件が両方とも「記録なし」と読めるため、照会してから別々に書く手順だけでは二重処理を防げません。
外部サービスへ書き込む場合は、受付DBの確定範囲に外部の副作用が入りません。外部への送信が成否不明になったら、相手が受け付ける依頼IDを同じ値で渡せるか、結果を照会できるかを先に設計します。受付記録だけから外部処理の完了を判定しません。
SQSからLambdaへ渡すバッチでは、部分バッチ応答を使うと失敗したメッセージを返せます。すでに成功したメッセージの再処理を減らせますが、処理側では同じ依頼を再び受ける場合に備えます。
同じ依頼が届いたときの判断を試す
選択すると、正誤と理由が表示されます。
確認して、自分の言葉で説明する
- 依頼元・依頼ID・処理内容がどこで決まるか確認する。
- 同じIDと内容、同じIDで異なる内容、別IDをそれぞれ試す。
- 保存後に応答を失ったと仮定し、保存結果をどこで再利用するか示す。
理解を確かめる: 受信メッセージを重複なく処理できたか確認するには、依頼IDに加えて何を見ますか?
同じ依頼IDに対応する確定済みの業務結果です。
受信記録や応答の有無だけでは、受付行や外部への書き込みが何度確定したか分かりません。
出典と確認した条件
説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。
確認した内容・条件依頼元が指定するID、記録の原子性、遅れて到着した依頼、内容の衝突。
参照した本文応答が消えても、保存が取り消されるとは限らない 依頼IDの範囲と、再試行時の応答を決める 受付行を保存する操作と、その記録の境界を合わせる
確認した内容・条件重複処理の可能性と部分バッチ応答の対象。
参照した本文受付行を保存する操作と、その記録の境界を合わせる