途中状態を持つ業務の流れを作る
注文が在庫予約、課金、通知へ進むとき、それぞれを別サービスのローカルトランザクションで確定する場合があります。Sagaはその連なりを進め、必要な失敗時に補償の操作を行う設計です。前提は分散トランザクションのガイドです。全ステップを一つの原子的なCOMMITへしたわけではなく、途中の予約が他から見える可能性を含めて業務を設計します。最初から「注文が完全に存在するか存在しないかだけ」と説明すると、実際に残る状態を隠します。
例では新規、予約済み、課金済み、完了、取消待ち、取消済み、要確認という状態を持ちます。最終的な課金拒否なら予約取消しへ進みますが、課金の応答不明なら要確認へ進め、同じ操作IDで照会するなどの契約を使います。どちらも例外だからと同じ取消しへ送らないでください。未完了の業務を利用者へどう表示するかも、この状態と対応させます。受付成功を、全ての効果の完了と同じ意味にしないことが出発点です。
確定した仕事と補償を対にする
在庫予約の補償は予約取消し、課金の補償は必要な条件での返金など、業務で意味を持つ別操作です。取消しを行っても、予約された事実を利用者が見たことや、既に送った通知は消えません。返金も手数料、時間、外部の制約を持つ場合があります。補償を元のSQLの逆演算だけとして実装せず、その時点で有効な業務規則を確認します。全ての効果に完全な逆操作があるという前提は置きません。
予約取消しが二回来ても在庫を二回戻さないよう、補償自体にもIDと状態を持たせます。元の業務操作と同じID空間へ無造作に混ぜず、何の取消しなのかを対応させます。取消し要求が遅れて届き、予約が別の状態へ進んだ場合も、許される遷移を確認します。古い指示が新しい業務を上書きしない条件が必要です。補償を送ったこと、受け付けたこと、確定したこと、確認したことを、元の処理と同じく別の境界で追います。
履歴から次の一手を選ぶ
予約成功、課金の最終拒否、取消し送信、取消し応答の喪失という履歴を考えます。最後の状態を「取消済み」と決めるのも、「未取消し」と決めるのも早過ぎます。取消しが既に確定した可能性があるためです。同じ取消しIDで再送して結果を得るか、状態を照会して確認します。補償をもう一度送るときにも、前の補償の結果不明を保ちます。新IDで同じ在庫を戻す要求を作るのは、二重補償の反例になります。
一つのSagaの状態は永続化し、再起動した担当がどこから続けるかを決められるようにします。ステップID、試行、結果、次の予定、必要な期限を保存します。操作結果と次のメッセージの予定を同じDBへ置けるならOutboxが役立ちます。受信側ではInboxや自然な業務一意性を使います。ただし全体の原子性へ変わるわけではありません。各ステップに残る待ちと観測可能な途中状態を、最後まで業務の仕様として扱います。
| 観測した状態 | 次の候補 |
|---|---|
| 予約成功・課金最終拒否 | 予約取消しへ |
| 予約成功・課金結果不明 | 課金結果の解決へ |
| 取消し応答喪失 | 同じ補償IDで照会・再送 |
| 補償不能な最終失敗 | 要確認と解決手順へ |
制御の置き場所を選ぶ
オーケストレーターが順番を指示する方式では、全体の進行を一か所で追いやすくなります。その担当の永続状態と再起動、二重担当を防ぐ条件が必要です。イベントに各サービスが反応する方式では、独立性が増える場合もありますが、全体が今どこにいるかを再構成する情報が散ります。循環するイベントや、誰も最終解決を担当しない状態を作らないよう、終了条件と責任を定めます。方式名だけで障害の扱いが簡単になるとはしません。
並行するSagaが同じ在庫を予約する場合、各ローカルステップの業務制約も必要です。Sagaがあるから在庫を負へしてよいわけではありません。予約の有効期限、解放、競合する更新の順序を、その資源のトランザクションへ合わせます。長いロックを避けられても、意味上の予約を保持して他の要求を待たせる費用は残ります。ロックがないという説明を、隔離の問題がないという結論へ広げないでください。
補償の失敗を終端へ押し込まない
取消し先が停止したら、期限と再送予算を使って再試行し、解決できない間は取消待ちとして残します。永久に再送し続けるだけでは、担当が失われた仕事と区別できません。古さ、試行数、最後の結果を観測し、必要なら担当者が確認する状態へ移します。実装がこの状態を持つことと、自動で人へ通知する機能があることは別なので、未実装の運用を成功したと説明しません。解決済みの記録も監査できるようにします。
全ステップが一つのDBへ入る小さな処理なら、ローカルトランザクションで済ませる方が単純です。厳密な共同確定が必要で参加者が対応する場合は別の方式も比較します。Sagaは長い業務で途中状態を許せるときに検討し、どの不変条件を常時守り、どれを後で解決するかを分けます。この教材の履歴は説明用で、本番サービスに予約や課金の試験を行った記録ではありません。実験では使い捨ての効果とIDでまず停止境界を確かめます。
期限切れの予約を別の遷移として扱う
予約に有効期限を付ける場合、自然に期限切れへ進む処理と、Sagaの取消しが競合する可能性があります。どちらも在庫を戻すなら、予約状態を一度だけ遷移させる条件が必要です。期限切れ後に課金成功が届く場合も、元の注文を無条件に完了へ戻しません。遅れた成功を受けた業務の解決手順を定め、取消しの応答を待つだけで全て揃うとはしないでください。
補償待ちの間に見える状態も、業務の契約として定めます。
補償の応答喪失を解く課題
課題は予約取消しの応答を失い、同じ在庫を新しい取消しIDで戻す案です。解答は、前の取消しが確定済みなら二回戻す可能性があるため、元の補償IDの結果を解決する必要がある、です。業務側が予約状態の遷移を一度に制限していれば、自然な一意性でも守れる場合があります。どちらを使う場合も、受信IDと状態の更新がどの確定へ入るかを確認します。「取消しだから安全」という理由だけでは足りません。
追加課題は、課金の結果不明を即時の最終拒否へ分類する案です。解答では、課金済みと予約取消しが併存し得る反例を示します。結果不明、最終失敗、補償待ち、補償完了を区別し、利用者へ見せる状態と対応させてください。前向きの処理と補償の両方について、ID、確定、応答、再起動後の担当を追えることが到達点です。