Event Sourcing入門:イベント駆動型設計パターン
Event Sourcing(イベントソーシング)の基礎を徹底解説。CRUDとの違い、CQRSとの連携、TypeScriptによる実装例、メリット・デメリットを紹介。
従来のソフトウェア開発では、大半のシステムが CRUD(Create, Read, Update, Delete)モデルを採用しています。データの変更が発生するたび(ユーザーの住所更新や銀行口座の残高変動など)、データベース上の対象レコードに対して UPDATE 文を実行し、最新値で上書きするのが一般的です。
しかし、この従来の手法には致命的な欠点があります。それは、過去の経緯や変更履歴が失われてしまう点です。口座残高が「500万円」と表示されていても、外部の監査ログがなければ「どのような取引を経てその金額になったのか」をデータベース単体から復元することはできません。
そこで登場したのが Event Sourcing(イベントソーシング) です。アプリケーションの最新状態を直接保存するのではなく、過去に発生した一連の「出来事(イベント)」を追記専用(Append-only)で記録し、必要に応じてそれらを再生(リプレイ)することで現在の状態を復元する設計パターンです。
1. 10歳でもわかる説明(ELI5)#
黒板 と お小遣い帳(台帳) の違いを思い浮かべてみてください。
- CRUDモデルは黒板のようなもの: 手元にリンゴが
3個あると黒板に書きます。お母さんからリンゴを2個もらったら、黒板消しで3を消して5と書き直します。部屋に入ってきた人は5という数字しか見えません。「買ったのか」「もらったのか」「それとも以前6個あって1個食べたのか」は誰にもわかりません。 - Event Sourcingはお小遣い帳のようなもの: 消しゴムは絶対に使いません。出来事が起きるたびに、新しい行を追記します。
- 1日目: お母さんからリンゴを3個もらった(+3)
- 2日目: リンゴを1個食べた(-1)
- 3日目: 友達からリンゴを3個もらった(+3)
今リンゴが何個あるか知りたい時は、最初から計算します:3 - 1 + 3 = 5個!もし2日目に「実は1個しか食べていないのに2個と誤記した」場合でも、ページを破り捨てるのではなく、「訂正:誤記したリンゴ1個を戻した(+1)」と次の行に書き足します。
[!NOTE] 最終的な「結果(State)」だけを保存するのではなく、結果に至るすべての「出来事(Events)」を記録するのがEvent Sourcingの本質です。
2. 従来のCRUDとEvent Sourcingの比較#
銀行口座の残高管理を例に、両者の違いを比較してみましょう。
| 項目 | 従来のCRUDモデル | Event Sourcingモデル |
|---|---|---|
| データの保存方式 | 最新のスナップショット(Current State)のみ保存。 | 発生したアクションの全履歴(Event Stream)を保存。 |
| DB操作 | CREATE, READ, UPDATE, DELETE。データを直接上書き。 | Append-only:追加(INSERT)と参照(SELECT)のみ。上書き・削除は不可。 |
| DB内の保存データ | 残高: 5,000,000円 | 1. 口座開設 (+0円)2. 入金 (+10,000,000円)3. 出金 (-3,000,000円)4. 出金 (-2,000,000円) |
| 誤り発生時の対応 | UPDATE で古い残高の上に新しい値を直接上書き。 | 相殺イベント(Compensating Event、例: 取消処理)を新しく追記。 |
| 情報の欠落 | あり。専用ログがない限り、過去のコンテキストは消失。 | なし。変更の全履歴が100%完全に保全される。 |
3. Event Sourcingの主要コンポーネント#
実運用におけるEvent Sourcingアーキテクチャは、主に以下の要素で構成されます。
- Event(イベント):
- 過去に発生したビジネス上の事実を表し、不変(Immutable) です。変更や削除はできません。
- 原則として過去形で命名されます(例:
AccountOpened,MoneyDeposited,OrderShipped)。
- Event Store(イベントストア):
- イベントを時系列順に追記保存(Append-only log)するための専用データベースです。
- システム全体における唯一の信頼できる情報源(Single Source of Truth - SSOT) となります。
- Aggregate(集約):
- ドメインのビジネスルールと整合性を担保するエンティティです。
- 過去のイベント履歴を順次適用(リプレイ)することで現在の内部状態を構築し、新しいCommandの妥当性を検証します。
- Projection(射影 / Read Model):
- 参照リクエスト(Query)のたびに数万件のイベントを再生するのはパフォーマンス上現実的ではありません。
- そのため、イベントを購読して参照に最適化されたデータベース(PostgreSQLやElasticsearch、Redisなど)に非同期で事前集計ビューを作成します。
[!TIP] スナップショット(Snapshots): 長期間運用されイベント数が数千〜数万件に達した集約では、定期的に状態のスナップショット(例: 100イベントごと)を保存します。復元時は最新のスナップショットから開始できるため、起動時間を劇的に短縮できます。
4. CQRSとの親和性#
Event Sourcingは、CQRS(Command Query Responsibility Segregation:コマンドクエリ責務分離)と組み合わせることで真価を発揮します。
- 書き込み側(Command): イベントストアへの単純な追記処理に特化しているため、複雑なテーブルロックや複数テーブルの同時更新を回避でき、非常に高い書き込みスループットを達成できます。
- 読み取り側(Query): UIや検索画面の要件に合わせて非正規化された読み取り専用DBを用意できるため、クエリの高速化と柔軟なスキーマ設計が可能になります。
5. TypeScriptによる実装例#
銀行口座の集約をEvent Sourcingで実装したミニマルなコード例です。
// 1. ドメインイベントの定義
type AccountOpenedEvent = {
type: 'AccountOpened';
accountId: string;
owner: string;
timestamp: string;
};
type MoneyDepositedEvent = {
type: 'MoneyDeposited';
accountId: string;
amount: number;
timestamp: string;
};
type MoneyWithdrawnEvent = {
type: 'MoneyWithdrawn';
accountId: string;
amount: number;
timestamp: string;
};
type BankAccountEvent = AccountOpenedEvent | MoneyDepositedEvent | MoneyWithdrawnEvent;
// 2. Aggregate Root: イベントから状態を再構築
class BankAccount {
public id: string = '';
public balance: number = 0;
public owner: string = '';
// 過去のイベント履歴を適用して状態を復元
public applyEvents(events: BankAccountEvent[]): void {
for (const event of events) {
this.mutate(event);
}
}
// イベントに応じた状態遷移関数
private mutate(event: BankAccountEvent): void {
switch (event.type) {
case 'AccountOpened':
this.id = event.accountId;
this.owner = event.owner;
this.balance = 0;
break;
case 'MoneyDeposited':
this.balance += event.amount;
break;
case 'MoneyWithdrawn':
this.balance -= event.amount;
break;
}
}
// 出金コマンドの処理(不変条件のチェックとイベント発行)
public withdraw(amount: number): MoneyWithdrawnEvent {
if (amount <= 0) {
throw new Error('出金額は0より大きい必要があります');
}
if (this.balance < amount) {
throw new Error(`残高不足です: 現在の残高 ${this.balance}円, 出金要求額 ${amount}円`);
}
const event: MoneyWithdrawnEvent = {
type: 'MoneyWithdrawn',
accountId: this.id,
amount,
timestamp: new Date().toISOString()
};
this.mutate(event);
return event;
}
}
// 3. イベント履歴の再生と残高検証のシミュレーション
const eventHistory: BankAccountEvent[] = [
{ type: 'AccountOpened', accountId: 'ACC-001', owner: 'Alice', timestamp: '2026-09-01T08:00:00Z' },
{ type: 'MoneyDeposited', accountId: 'ACC-001', amount: 10_000_000, timestamp: '2026-09-01T09:00:00Z' },
{ type: 'MoneyWithdrawn', accountId: 'ACC-001', amount: 3_000_000, timestamp: '2026-09-02T10:00:00Z' },
{ type: 'MoneyWithdrawn', accountId: 'ACC-001', amount: 2_000_000, timestamp: '2026-09-03T11:00:00Z' }
];
const account = new BankAccount();
account.applyEvents(eventHistory);
console.log(`口座名義: ${account.owner}`);
console.log(`現在残高: ${account.balance.toLocaleString('ja-JP')} 円`); // 5,000,000 円typescript6. メリットとデメリット#
メリット#
- 完全な監査証跡(Audit Trail): システムで起きた全ての変更履歴が保存され、過去の任意の時点における状態を忠実に再現(タイムトラベルデバッグ)できます。
- 優れた書き込み性能: イベントの保存は追記処理(Append-only)のみで行われるため、ロックの競合がなく高速に完了します。
- リッチな行動分析: 単なる最終状態だけでなく「カートに何回追加して削除したか」といったユーザー行動の変遷を丸ごと分析できます。
- スキーマ変更への耐性: 将来新しい集計データや分析が必要になっても、過去の全イベントを新しいプロジェクションに流し込むだけで簡単にバックフィルできます。
デメリット#
- 設計・実装の複雑さ: 状態中心の思考からイベント駆動のモデリングへの意識変革が求められます。
- 結果整合性(Eventual Consistency): プロジェクションへの反映が非同期の場合、書き込み直後の読み取りで一時的なラグが発生する可能性があります。
- イベントのバージョン管理(Event Evolution): 長期運用に伴ってイベント定義が変更された際、過去の旧形式イベントとの互換性を保つ仕組み(Upcastingなど)が必要になります。
[!WARNING] 単純なCRUDアプリケーションや変更履歴が重要でない小規模システムにEvent Sourcingを導入すると、オーバーヘッドがメリットを上回ってしまいます。要件に応じた適切な選定が重要です。
7. 参考文献#
- Event Sourcing: Event-Driven Architecture Under 5 Minutes ↗
- Event-Driven Architecture cho hệ thống sản xuất phản ứng ↗
- Event Sourcing là gì? - Viblo ↗
- Giải thích về Event Sourcing - Viblo ↗
- CQRS và Event Sourcing: Tách biệt đọc ghi và lưu trữ lịch sử sự kiện - FIT NEU ↗
- Domain-Driven Design with CQRS & Event Sourcing - VOZ ↗
- Event Sourcing vs Event Streams - Reddit Software Architecture ↗