INFRASTRUCTURE LEARNINGインフラ学習
インフラ大全インフラ大全IT INFRASTRUCTURE / LEARNING
インフラ学習ガイド
教材・演習を探す/

Escで閉じる · 検索語は送信しません

LEARNINGEN

テーマ別の解説テーマ:イベント駆動処理の設計

冪等性とは?再試行で二重処理を防ぐ設計

同じ依頼を何度受けても、業務上の結果を一度分に保つ性質を冪等性と呼びます。 画像変換の受付を例に、処理が成功した直後に応答を失うとき、依頼IDと保存結果を使って再試行に応じる流れを学びます。

この教材で学ぶこと

依頼IDを再利用する範囲を説明し、重複・内容の衝突・成否不明を区別して、受付記録と副作用をどこで確定するか判断できる。

先に知っておくこと

SQSではメッセージが再配信される場合があります。ここでは受付行を保存する架空のサービスを使い、実AWSやDBへの接続なしで確認します。

応答が消えても、保存が取り消されるとは限らない

依頼を送った側がタイムアウトしても、受け取った側で処理が始まっていない場合と、結果がすでに保存された場合があります。再試行の可否を、応答を受け取れたかどうかだけで決めると、同じ結果を二重に作る恐れがあります。

架空の受付で、最初の応答が送信側に届かなかった場合
架空の受付で、最初の応答が送信側に届かなかった場合1: 依頼元 — img-42 を送信 — 画像変換の受付. 2: 画像変換の受付 — 初回に1件を保存 — 受付データベース. 3: 受付データベース — 受付が同じ結果を返す — 再試行した依頼元123依頼元画像変換の受付受付データベース再試行した依頼元架空の受付で、最初の応答が送信側に届かなかった場合1: 依頼元 — img-42 を送信 — 画像変換の受付. 2: 画像変換の受付 — 初回に1件を保存 — 受付データベース. 3: 受付データベース — 受付が同じ結果を返す — 再試行した依頼元123依頼元画像変換の受付受付データベース再試行した依頼元
  1. 依頼元 → 画像変換の受付img-42 を送信
  2. 画像変換の受付 → 受付データベース初回に1件を保存
  3. 受付データベース → 再試行した依頼元受付が同じ結果を返す
依頼元
依頼ID img-42 を保持
画像変換の受付
依頼IDと内容を照合
受付データベース
受付行と結果IDを確定
再試行した依頼元
同じ結果ID J-81 を受け取る

依頼IDは送信側が意図した作業の単位です。同じ操作を再送するときは同じIDを使い、同じ画像でも別の変換を新たに依頼するときは新しいIDを使います。画像の内容だけで依頼をまとめると、正当な二度目の依頼まで失う場合があります。

依頼IDの範囲と、再試行時の応答を決める

教材用の受付内容。サイズの違う変換は別の依頼になる
{
  "requestId": "img-42",
  "image": "sample.png",
  "width": 640
}
初回に依頼元Aの img-42、幅640を結果 J-81 として保存した後
受け取った内容保存記録との照合受付側の判断
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へ渡すバッチでは、部分バッチ応答を使うと失敗したメッセージを返せます。すでに成功したメッセージの再処理を減らせますが、処理側では同じ依頼を再び受ける場合に備えます。

同じ依頼が届いたときの判断を試す

選択すると、正誤と理由が表示されます。

受付済みか不明な img-42 を、同じ依頼内容で再送します。どのIDを送りますか?
答えと理由を読む

正解:img-42 を再利用する · 同じ操作意図を表すIDを再利用すれば、受付側が保存済みの結果を照合できます。

同じ依頼元から img-42 で異なる変換幅が届きました。どう扱いますか?
答えと理由を読む

正解:衝突を返す · 同じIDが異なる操作内容を指しているため、確定済みの受付を保って衝突を返します。

同じ依頼が並行して届きます。二重の受付行を書かないために使うのは?
答えと理由を読む

正解:依頼元とIDの一意制約を使い、結果を同じトランザクションで確定する · DB側が一意性を守る書き込みで、確認と確定の間の競合を扱います。

外部への送信後に通信が切れ、相手の書き込み結果が不明です。先に何を照合しますか?
答えと理由を読む

正解:外部側の依頼IDと処理結果 · 同じ依頼IDで、外部側に確定済みの結果があるかを確かめます。

確認して、自分の言葉で説明する

  1. 依頼元・依頼ID・処理内容がどこで決まるか確認する。
  2. 同じIDと内容、同じIDで異なる内容、別IDをそれぞれ試す。
  3. 保存後に応答を失ったと仮定し、保存結果をどこで再利用するか示す。
理解を確かめる: 受信メッセージを重複なく処理できたか確認するには、依頼IDに加えて何を見ますか?

同じ依頼IDに対応する確定済みの業務結果です。

受信記録や応答の有無だけでは、受付行や外部への書き込みが何度確定したか分かりません。

出典と確認した条件

説明に用いた公式資料を、確認した内容・条件と本文の参照箇所に分けてまとめています。専門家による監修・実際のAWSとの比較検証は行っていません。