AgentSkillsCN

cqrs-to-event-sourcing

逻辑性地解释为何在 CQRS 实现中事件溯源是必然需求。逐步分析 C 侧到 Q 侧的数据同步问题(计算值无法同步、触发器局限、轮询的可扩展性问题、双重提交问题),并展示如何最终转向以事件作为真正数据源的设计。适用于 CQRS 引入评估及架构设计阶段。适用语言:与具体语言无关。触发条件:“CQRS 是否需要事件溯源”、“C 侧与 Q 侧的同步方式”、“CQRS 是否无需划分模型”、“读模型的更新方式”、“为什么需要事件溯源”、“双重提交问题”、“CQRS 的同步问题”、“CQRS 是否能在没有 ES 的情况下运行”等与 CQRS/ES 必然性相关的请求。

SKILL.md
--- frontmatter
name: cqrs-to-event-sourcing
description: >
  CQRSの実装においてイベントソーシングが必然的に必要となる理由を論理的に説明する。
  C側からQ側へのデータ同期問題(計算された値の同期不可、トリガーの限界、ポーリングの
  スケーラビリティ問題、ダブルコミット問題)を段階的に分析し、イベントを真のデータソースに
  する設計への到達過程を示す。CQRS導入検討、アーキテクチャ設計時に使用。
  対象言語: 言語非依存。
  トリガー:「CQRSにイベントソーシングは必要か」「C側とQ側の同期方法」
  「CQRSでモデルを分ける必要はないのか」「リードモデルの更新方法」
  「なぜイベントソーシングが必要か」「ダブルコミット問題」「CQRSの同期問題」
  「CQRSはESなしでも動くか」といったCQRS/ES必然性関連リクエストで起動。

CQRSはなぜEvent Sourcingになるのか

CQRSを実装すると、C側からQ側への同期問題に直面し、イベントソーシングに至る。これはオプションではなく、実装上の必然である。

よくある誤解: 「CQRSはモデルを分ける必要がない」

この解釈は危険な誤読である。

正しい意味は「システムのうち、CQRS領域と非CQRS領域に分けることができ、CQRSを部分導入できる」ということ。モデルを分けなくてよいのは非CQRS領域であり、CQRS領域内ではコマンドモデルとクエリモデルの分割は必須。

code
システム全体
├── CQRS領域     → モデル分割は必須
└── 非CQRS領域   → 分割不要(従来のCRUDで十分)

「CQRSはモデルを分割しなくてもいい」という解釈は、もはやCQRSではない。

C側とQ側のデータの違い

CQRSにおいて、C側(コマンド)とQ側(クエリ)のデータは根本的に異なる。

具体例: カートシステム

C側テーブル(ドメインモデルの永続化に必要な最小データ):

カートテーブルカートアイテムテーブル
カートID (PK)カートアイテムID (PK)
顧客アカウントIDカートID (FK)
上限予算金額商品ID
作成日時数量
作成日時

Q側テーブル(表示・検索に必要なデータ):

カートテーブルカートアイテムテーブル
カートID (PK)カートアイテムID (PK)
顧客アカウントID商品ID
顧客アカウント名 ★商品名 ★
上限予算金額数量
合計金額単価
価格

★の値はC側のデータベースに存在しない。ドメインオブジェクトの振る舞いによって計算される派生値である。

scala
case class Cart(id: CartId, items: CartItems, ...) {
  // 合計金額はドメインオブジェクトの計算結果であり、DBに保存されない
  def totalPrice(priceResolver: ItemId => Price): Price =
    items.fold(Price.zero){ (t, item) => t + item.price(priceResolver) }
}

case class CartItem(id: CartItemId, itemId: ItemId, quantity: Quantity, ...) {
  // 単価は外部から提供され、価格は計算される
  def price(priceResolver: ItemId => Price): Price =
    priceResolver(itemId) * quantity
}

同期方法の段階的検討と限界

方法1: トリガーによる同期

C側のテーブル更新時にSQLでQ側を書き込む。

限界:

  • 静的データ(顧客名等)の転送には有効
  • 計算された値(★)は同期できない - ドメインロジックの計算結果はDBに存在しない
  • 同じ計算ロジックのSQLを書くのは困難であり、ビジネスロジックの重複を生む
  • 苦肉の策として計算結果もC側に保存すると、リポジトリのインターフェースが歪む
scala
// ❌ リポジトリに計算ロジックの責務が漏れる
trait CartRepository {
  def store(cart: Cart, priceResolver: ItemId => Price): Unit
  // priceResolverはリポジトリの責務ではない
}

方法2: ポーリングによる同期

プログラムでC側テーブルを読み込み、ドメインオブジェクトで計算後、Q側に書き込む。

限界:

  • 計算結果のQ側転送は可能
  • 「いつ変更されたか」を検知できない - 変更トリガーがない
  • 全集約をポーリングする必要があり、スケーラビリティがない
  • 大量の集約が存在する場合、実用的ではない

結論: 最新状態を手に入れるにしても、更新イベントが必要

方法3: イベント通知キューの導入

変更時にイベントをキューに発行し、Q側更新プログラムがイベントを受信して同期する。

code
C側リポジトリ → RDB(テーブルA) + メッセージキュー(更新イベント)
                                         ↓
                            リードモデル更新プロセス
                                         ↓
                            C側テーブルから集約再現 → Q側テーブル書き込み

限界: ダブルコミット問題が発生する。

  • RDBとメッセージキューは異なるストレージ
  • 同一トランザクションに統合できない
  • RDBへの書き込み成功 + キューへの書き込み失敗(またはその逆)が起こりうる
  • 高いコストを払う可能性がある

必然的な到達点: イベントソーシング

ダブルコミット問題を回避するには、イベントを真のデータソースにする

設計の転換

code
従来:
  C側DB(状態を保存) + メッセージキュー(通知用)
  → 2つのストレージへの書き込み = ダブルコミット問題

イベントソーシング:
  イベントストア(イベントが真のデータソース)
  → 1つのストレージへの書き込みのみ
  → C側の状態はイベントから導出
  → Q側の状態もイベントから導出

結果

  • C側のDBはRDBである必要がなくなる(イベントの追記とIDごとの読み込みが可能なシステムであれば何でもよい)
  • NoSQL(KVS)が適している場合が多い
  • DynamoDB Streamsなどでスケーラブルにイベント読み込みが可能
  • これがEvent Sourcing
code
イベントストア(真のデータソース)
    │
    ├──→ C側: イベントからドメイン状態を再構築
    │
    └──→ Q側: イベントからリードモデルを構築
              (計算された値も含めて自由に構築可能)

CQRSシステムのほとんどがEvent Sourcingを採用する理由

Lightbend社の調査によると、CQRSシステムのほとんどがEvent Sourcingを採用している。

段階方法問題
1トリガー計算された値を同期できない
2ポーリング変更検知できない、スケールしない
3イベントキューダブルコミット問題
4Event Sourcing上記すべてを解決

Event Sourcingはオプションではなく、CQRSを真剣に実装すると必然的に到達する設計パターンである。

判断フロー

code
CQRSの導入を検討している
    ↓
C側とQ側のデータは同一か?
    ├─ YES → CQRSは不要。従来のCRUDで十分
    └─ NO(Q側に計算値・結合データがある) ↓
        C→Qの同期をどうするか?
        ├─ トリガー → 計算値は同期できない
        ├─ ポーリング → 変更検知・スケーラビリティの問題
        ├─ イベントキュー → ダブルコミット問題
        └─ Event Sourcing → すべて解決

関連スキルとの関係

スキル関係
cqrs-tradeoffsCQRSの一貫性・可用性・スケーラビリティ。本スキルはESが必要な理由
aggregate-transaction-boundaryトランザクション境界。本スキルはC→Q同期の問題
cross-aggregate-constraints集約間制約。本スキルとは別次元の問題

レビューチェックリスト

CQRS設計

  • CQRS領域と非CQRS領域を明確に分離しているか
  • CQRS領域内でコマンドモデルとクエリモデルを分割しているか
  • 「CQRSだがモデルは分けない」という矛盾した設計になっていないか

C→Q同期

  • Q側に必要なデータの中に、C側DBに存在しない計算値があるか確認したか
  • 計算値がある場合、トリガーでは解決できないことを理解しているか
  • C→Q同期の仕組み(イベント駆動)が設計されているか
  • ダブルコミット問題を認識し、対処しているか

Event Sourcing

  • イベントを真のデータソースとする設計か
  • C側の状態がイベントから導出可能か
  • Q側のリードモデルがイベントから構築可能か

関連スキル(併読推奨)

このスキルを使用する際は、以下のスキルも併せて参照すること:

  • cqrs-tradeoffs: CQRS採用判断のトレードオフ分析
  • cqrs-aggregate-modeling: イベントソーシング下での集約モデリング
  • aggregate-transaction-boundary: イベントストアによるダブルコミット問題の解消