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

Event sourcingで履歴から状態を作る

入出金の履歴とsnapshotから、決定的な再生、同時追加、イベントの進化、訂正、外部効果の境界を考えます。

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

更新日

この記事の目次
  1. 現在値ではなく履歴を正本にする
  2. 同じ初期状態から同じ順に適用する
  3. 同時更新を期待する版で制御する
  4. イベントの版を将来も読めるようにする
  5. 再構築と日常運用の費用を見る
  6. 拒否した要求を履歴と混ぜない
  7. snapshotと訂正の課題を解く
  8. この記事をロゲイアに質問する理解を確かめる

現在値ではなく履歴を正本にする

残高の現在値80だけを保存する代わりに、入金100、出金20という確定した出来事を順に保存し、その履歴から80を作る方式を考えます。Event sourcingは、このイベント列を状態の正本へ置く設計です。前提は状態機械とCQRSです。通常のDBへ現在値を更新し、参考のログも残す方式とは、どちらを失ったときに何から復旧するかが違います。ログという名前が付いているだけで、状態を再構成できる正本とは限りません。

イベントは、受け付けてよいか未決定の要求ではなく、既に確定した業務上の事実として扱います。出金要求20を受けて残高の条件を検査し、許可した結果として出金確定20を追加する、という違いです。要求を何でもそのまま履歴へ入れ、再生時に現在の規則で許否を決めると、同じ履歴から違う状態を作る危険があります。何を確定した時点の事実として保存し、どこで不変条件を検査するかを先に定めます。

同じ初期状態から同じ順に適用する

残高0から入金100を適用すると100、続く出金20で80です。追加で訂正入金5を記録すれば85です。履歴の途中の出金20を25へ直接書き換えると、以前の参照や監査が見た内容と食い違います。訂正を新しい事実としてどう表すかを業務で決め、元のイベントを黙って別の意味へ変えません。履歴の不変性と、法令や製品の削除要件をどう両立するかも、保存する情報を選ぶ時点から考える必要があります。

適用関数は、同じ初期状態と同じイベント列から同じ結果を作るようにします。再生の途中で現在時刻や外部APIを読めば、今日と明日で違う値になる可能性があります。時刻やレートが事実の一部なら、確定時に必要な値を記録するなどの設計を使います。再生したからといって、通知や実決済をもう一度実行しません。状態を計算する処理と、外部の効果を送る処理の境界を分け、再構築の作用先を明示します。

位置確定イベント適用後の残高
1入金100100
2出金2080
3訂正入金585

同時更新を期待する版で制御する

二つの出金がどちらも残高100を読み、80ずつ出そうとした場合、両方を無条件に追加すると負になるかもしれません。集約の現在の版を条件として追加し、一方の確定で版が進んだら、もう一方は読み直して業務の可否を判断する方式が使えます。期待版2の後へイベントを追加する操作と、版の確認を一つの原子的な境界へ置きます。事前に版を読むだけでは、確認と追加の間に競合が入ります。

再送で同じコマンドを二回追加しないための操作IDも別に必要です。イベント位置が一意でも、別の位置へ同じ業務要求の二回目を追加できるからです。集約単位の順序と、複数集約にまたがる取引も区別します。一口座のイベントが順序付けられていることから、二口座の振替が同時に確定するとは言えません。複数資源の保証が必要なら、分散トランザクションやSagaの境界へ戻ります。履歴の形だけで業務の全制約を解こうとしません。

イベントの版を将来も読めるようにする

過去のイベントへpriceという項目があり、後から通貨や税の項目が必要になった場合を考えます。古い事実が何を意味したかを保ち、イベントの種類と版に応じた読取りを用意します。古い値へ現在の税率を勝手に適用すると、同じ履歴から違う合計を作ります。変換するなら元の情報で意味を保てるかを検証し、足りない情報を推測して埋めた場合は正確な再生と区別します。イベントの進化は、現在行の列を増やすだけの変更より長い互換性の責務を持ちます。

snapshotはある位置まで適用した状態の近道です。位置2の残高80を読み、位置3以降を適用すれば85へ進めます。snapshotの位置、スキーマ、作成条件を確認し、履歴との対応を保ちます。snapshotを持つだけで履歴を削除してよいとは限りません。過去の投影再構築や監査が必要か、古いsnapshotが壊れたとき何から戻れるかを検討します。性能のための近道と、正本の保持方針を同じ判断へ潰さないようにしてください。

再構築と日常運用の費用を見る

イベント列から読取り投影を作る場合、consumerの遅れ、重複、順序、再構築世代をCQRSと同じく扱います。履歴があるから一瞬でどんな照会にも答えられるわけではありません。長い再生のCPUとI/O、追加の保存、イベント形式の保守、削除対応が費用になります。新しい投影を作るとき、実際にどこからどこまで再生できるかを試します。最新残高だけが合っても、過去の意味や全ての投影が正しいことの証明にはなりません。

単純なCRUDで状態の履歴を完全に再構築する必要がない場合、現在行と目的に合う監査で足りることがあります。Event sourcingは、履歴が正本である利益が進化と復旧の費用に見合うかで選びます。監視では追加の競合、再送、未対応の版、再生失敗、投影の遅れを分けます。障害時には最後の確定位置と操作IDを使い、ログの印字順から勝手にイベントを並べ替えません。再生の副作用が止められているかも、実行前に確かめます。

拒否した要求を履歴と混ぜない

残高80で100の出金を拒否した場合、残高を減らす確定イベントを追加しません。拒否の監査を残すなら、状態を再生する事実の列とどう区別するかを決めます。拒否要求を通常の出金イベントとして保存し、再生時に無条件で引くと、当時守った不変条件を壊します。イベントの名前と適用関数が、その事実が確定した意味を共有することが必要です。

拒否の記録と確定した事実の意味を、再生でも揃えます。

snapshotと訂正の課題を解く

課題は位置2のsnapshotが残高80で、その後に訂正入金5がある場合です。解答は位置3を一度だけ適用して85です。位置2までのイベントをsnapshotへもう一度足すと二重計算になります。逆に位置だけ新しくして値が80のままなら、訂正を取り込まずに済んだと誤判定する危険があります。snapshotの値と位置を同じ確定へ対応させる必要を説明してください。二つが揃った事実が、再生を省く根拠です。

追加課題は、再生時に現在の外部レートを読んで過去の円換算を計算する案です。解答は、同じ履歴から同じ状態を作る契約を破る可能性があると説明します。確定当時のレートを保存する、換算を現在時点の別照会にするなど、目的へ合う境界を選びます。正本のイベント、操作ID、集約の版、snapshot、投影の五つを区別できれば到達点です。

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

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

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

学習コースから次を選ぶ