設計パターン・最適化図鑑 · 基礎から応用へ

Transactional Inboxで受信と効果を揃える

受信IDと業務更新を同じ確定へ置き、並行受信、別内容の再利用、保持期間、再構築の境界を考えます。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 同じ通知が二回来る前提へ立つ
  2. 順番を変えるだけでは足りない
  3. 並行受信には一意制約を使う
  4. 保持期間を配送の再開と合わせる
  5. 失敗を残して再開できるようにする
  6. 同じ配送と別の事実を区別する
  7. 三日前の再送を判断する課題
  8. この記事をロゲイアに質問する理解を確かめる

同じ通知が二回来る前提へ立つ

Outboxから注文の通知を受け、在庫や投影を更新するconsumerを考えます。送信側が応答を失えば、同じイベントが再送されます。Transactional Inboxは、受信IDの記録と、そのイベントが作るローカルな業務効果を同じトランザクションへ置き、重複配送で同じ効果を繰り返さない設計です。前提はOutboxと冪等性です。メッセージが一度しか届かない仕組みではなく、二回以上届いても扱える受信側の境界を作ります。

event-7を受けて在庫10を9へ変える場合、処理済みIDがないことを確認し、IDと減算を一緒に確定します。再送ではIDがあるため効果を増やさず、必要な確認応答を返します。受信履歴と効果を同じDBへ入れられることが成立条件です。別の外部APIへ実決済を送る場合、その効果はこのDBの中にありません。Inboxを採用したという名前だけで、受信から全外部システムまでの一回限りを約束しないでください。

順番を変えるだけでは足りない

IDを先に確定してから業務更新をする案では、IDの確定後に停止すると、再送を処理済みと判断するのに効果はありません。逆に業務更新を先に確定すると、ID保存前の停止で再送がもう一度効果を作ります。二つを順に行うだけでは、消失と重複のどちらかの隙間が残ります。同じトランザクションなら、確定前の停止では両方をやり直し、確定後の停止では保存済みの結果を使う、という境界を作れます。

確認応答はその確定の後へ置きます。応答後に確定する順なら、送信側が成功と思って予定を捨てたのに、受信側の効果が失われる可能性があります。確定後・応答前の停止は重複配送を作りますが、同じIDの効果を再実行しない構造で扱います。この二つを混同せず、配送のackと業務のcommitを表に別々に書いてください。採用DBのトランザクションと永続化の契約も、応答が何を意味するかに含めます。

確定方法間で停止した状態
ID→効果の別確定IDあり・効果なし
効果→IDの別確定効果あり・IDなし
同じ確定両方確定か両方未確定

並行受信には一意制約を使う

同じIDが同時に二つのworkerへ届く場合、両方が「まだない」と照会してから効果を作る危険があります。アプリの事前照会だけを排他制御とみなさず、IDの一意制約とトランザクションの競合処理を使います。新規の挿入に成功した側だけ効果を作り、競合した側は保存済みの内容と結果を確認します。使用するDBで、競合が待つか、文だけ失敗するか、トランザクションが失敗状態になるかを確かめて実装します。

処理済み行にはIDだけでなく、対象の業務主体やイベントの種類、必要なら内容の指紋と結果を持たせます。同じIDで別の数量が来たら、古い成功を無条件に返さず不一致を検出します。指紋を使う場合は正規化の規則と衝突を扱う前提も必要です。個人情報を丸ごと複製する必要があるとは限らないので、照合と監査に必要な情報を選びます。IDの空間が送信者ごとなら、送信者とIDの組を一意にするなど、正しい範囲を指定します。

保持期間を配送の再開と合わせる

InboxのIDを一日で消し、送信側が三日前の未送信行を再送できるなら、そのイベントは新規として効果を作る可能性があります。保持期間は、通常の再送だけでなく、障害復旧、保管したイベントの再投入、バックアップ復元からの再開と合わせます。永久保持は容量と削除要件の費用を増やすので、無条件の答えではありません。効果の自然な一意性や集約ごとの連番を使えるかも含め、古いイベントへ何を約束するかを決めます。

新しい投影を一から作る場合、過去のInboxが全イベントを処理済みと見なすと、必要な再構築を止めることがあります。受信先の投影世代やconsumerの意味が変わるときは、重複排除の空間も設計します。業務の本体へ同じ効果を再適用することと、別の空の投影へ履歴を再生することは違います。単純に全IDを消して再生する運用は、外部効果も繰り返す危険があるので、再生対象と作用先を明確に分けます。

失敗を残して再開できるようにする

内容が不正で業務更新できないイベントを、成功したInboxへ記録して捨てると、修正して再送しても届かなくなります。失敗、隔離、再試行可能、最終的な業務上の拒否を区別します。全てのエラーを無限再送すると後ろを塞ぐので、運用で確認する状態も必要です。成功として保持するものと、別の失敗記録をどのタイミングで保存するかを決めます。IDを付けただけでは、この解決の方針は決まりません。

監視では配送件数、新規ID、重複ID、不一致、効果件数、古い行、滞留を分けます。配送が二回で効果一回なら、正常な重複処理かもしれません。重複を全て障害として隠さず、想定した履歴と比べます。付属実験は実consumerとrelayの再起動でこの境界を確かめます。小規模な順次受信のSQLiteでの結果を、任意の並行consumerや本番DBの保証へ一般化しません。単純な一回の処理だけで済む場面なら、既存の業務一意制約で十分かも検討します。

同じ配送と別の事実を区別する

同じ注文について作成event-7と取消event-8が届くなら、注文IDだけをInboxの一意キーにすると後者まで重複として捨てる危険があります。一意にしたいのは、今回のconsumerで一度だけ効果を作るイベントの識別です。注文、操作、配送の各IDの役割を分けます。再送では同じイベントID、別の業務事実では別のIDという対応を、送信側の規則と合わせて検証します。

三日前の再送を判断する課題

課題はIDを一日後に削除したconsumerへ、三日前のevent-7を再送する場合です。解答では、そのIDを知らないため新規効果を作り得ると説明します。保持期間を延ばす、古いイベントの受入れを制限する、業務の一意性でも守るなど、約束に合う対策が必要です。「以前は処理済みだった」という運用者の知識だけでは、削除後のDBが重複を判定できません。何をいつまで保存するかを、送信側の再開条件と同じ表へ置きます。

追加課題は、ID一件・効果0件なのに「重複処理は成功」とする判断です。解答は、IDだけが先に確定した誤りの可能性があるので、効果との対応も検査する必要がある、です。確認応答の前後、IDの確定、効果の確定を履歴で追ってください。配送、新規ID、業務効果の三つを別の数として説明でき、並行受信と保持期限の前提も述べられれば到達点です。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

サーバーの中で起きていること · STEP 17

学習コースから次を選ぶ