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

CQRSで更新と照会の責務を分ける

注文の書込みと一覧投影の遅れから、権威、再送、反映位置、再構築、Event sourcingとの違いを考えます。

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

更新日

この記事の目次
  1. 更新の規則と表示の形を分ける
  2. コマンドの結果を照会の結果と区別する
  3. 重複と順序を投影へ反映する
  4. 再構築を独立した作業として設計する
  5. 単純なCRUDと費用を比べる
  6. 一つのDB内でも責務は分けられる
  7. 表示直後の取消しを判断する課題
  8. この記事をロゲイアに質問する理解を確かめる

更新の規則と表示の形を分ける

注文を確定するときは、在庫や状態遷移の規則を守る必要があります。一覧画面は、商品名、合計、最近の状態をまとめて速く読みたいかもしれません。CQRSは、変更を受付けるモデルと、照会へ答えるモデルの責務を分ける考え方です。前提は複製と整合性です。読取り専用の形を別に作ることで、更新の規則と画面の都合を独立に扱えます。ただし二つを別のマイクロサービスや別DBへ分けなければCQRSでない、とは限りません。必要な境界から始めます。

例では書込み側へorder-7の受付を確定し、読取り側の注文一覧へ後から反映します。受付の応答が成功でも、一覧は一時的に注文をまだ表示しない可能性があります。この遅れを利用者へどう見せるかが設計に入ります。自分の注文直後の確認だけ書込み側の結果を使う、反映位置まで待つ、処理中を表示するなど、必要な鮮度へ合わせます。モデルを分ければ自動で強い整合性も得られるという説明にはしません。

コマンドの結果を照会の結果と区別する

コマンドは「この注文を取消してよいか」の判断を伴う操作です。書込み側は現在の状態を確認し、許される遷移を確定します。照会は「一覧へ何を表示するか」に答えます。古い投影の取消可能という表示だけを信じて、書込み側の規則を省略しないでください。表示の直後に別の操作が進む場合もあります。更新の可否は、権威を持つ側の最新の契約で判定します。読取りモデルは、書込みの不変条件を無条件で決める正本ではありません。

コマンドの成功応答には、操作ID、確定した状態、必要なら反映位置を含める設計が考えられます。その位置より前の投影なら、まだ追い付いていないと判断できます。単に壁時計で一秒待てば必ず反映されるという方式は、遅延が伸びたときに破れます。位置は何の履歴の番号か、複数シャードでは一つの番号で表せるかも確認します。ラベルを付けただけで、投影が実際に必要な位置まで処理した証明にはならないので、consumerの確定位置と対応させます。

重複と順序を投影へ反映する

注文作成、支払確定、取消しのイベントを一覧へ反映する場合、同じ作成が二回来ても件数を二回増やさない必要があります。投影の更新と処理済みの位置やIDを、同じトランザクションへ置く設計が使えます。到達後の応答喪失で再送される履歴をOutboxとInboxの記事で追ってください。状態を単に最後に届いた内容へ上書きすると、遅れて来た作成が取消済みを受付済みへ戻す可能性があります。順序の単位と古い更新の扱いを定めます。

全てのイベントを同じ全順序へしなければならないとは限りません。注文単位の番号で十分なら、その単位の前後を保ちます。一方、全店舗の合計など複数の流れをまとめる投影では、どこまで反映済みかの表現が複雑になります。イベントの欠落、再投入、スキーマ変更も投影の契約へ含めます。全体件数が合っただけで個々の注文が正しいとは言えないので、対象の状態と反映位置をセットで検証します。

段階書込み側読取り側
作成確定order-7受付済み・位置10位置9・まだ未表示
投影反映位置10のまま位置10・受付済み表示
取消確定直後取消済み・位置11位置10・一時的に古い表示

再構築を独立した作業として設計する

読取りモデルを変えるときは、新しい空の投影へ履歴や正本から再構築し、追い付いてから参照先を切り替える方法があります。途中の空の表を利用者へ公開しないよう、世代と切替の条件を持ちます。既存のconsumerの処理済みIDをそのまま流用すると、新しい投影へ必要な過去イベントを重複と判断して捨てる場合があります。再構築の作用先と、通常の業務効果の作用先を区別し、再生で通知や課金を再実行しないようにします。

CQRSはEvent sourcingと独立です。書込み側を通常の現在行として保存し、変更通知や再計算で読取り側を作ることもできます。逆に履歴を正本へする方式なら、その保持と進化の条件を追加します。CQRSを採用しただけで全過去状態をいつでも復元できるとは言えません。どの入力から投影を作り直せるか、欠けた履歴はどう補うかを明示します。再構築の時間と資源が通常の照会へ影響しないかも検証対象になります。

単純なCRUDと費用を比べる

照会と更新の形が似ていて、一つのDBの索引やビューで足りる場合、分けた投影は不要な遅れと運用費用を増やします。読取りの量だけでなく、別の形が本当に必要か、更新頻度、許す鮮度、再構築の費用を比較します。データを複製するなら権限や削除の対応も増えます。書込み側で消した個人情報が投影へ残り続けないよう、仕様と処理を揃えます。性能のためという理由で、利用者に必要な削除や可視性の契約を省きません。

観測ではコマンドの完了、投影の遅れ、再送、処理不能なイベント、世代ごとの進捗、照会の時間を分けます。照会が速くても何日も古いなら、目的を満たさない場合があります。書込み直後の表示を一つの代表履歴で確かめ、古い表示が許される範囲をテストします。付属の複製遅延の実験は反映待ちを扱う決定的な模型です。実DBやネットワークの性能測定とは区別し、実装した投影の検証はその後に対象の保存系で行います。

一つのDB内でも責務は分けられる

更新用の表と照会用のビューを同じDBへ置く構成でも、受け付ける操作と返す形を別に設計できます。非同期の別DBへ投影する費用を最初から引き受ける必要はありません。ただし同じDBにあるから全照会が自動で同じsnapshotを使うとも限りません。選んだトランザクションとビューの保証へ合わせて、更新直後の代表例を確認します。

表示直後の取消しを判断する課題

課題は投影が位置10の受付済みを表示する一方、書込み側は位置11で既に取消済みの場合です。解答では、表示が古くても取消しのコマンドは書込み側の規則で判定し、二度目の取消しを安全に扱う必要があると説明します。位置10を正しい最新状態として業務を更新しません。利用者には受付結果と、投影の反映状態を必要に応じて区別して示します。単に「最後に表示した値」を全更新の前提へしてはいけません。

追加課題はCQRSを導入したらEvent sourcingも必須かです。解答は必須ではありません。現在行の正本から投影を作る方法もあり、過去履歴を正本へする別の判断が残ります。何を確定し、何を派生させ、どう追い付き、どう作り直すかを説明できれば到達点です。Event sourcingの記事では、履歴そのものを正本にした場合の追加の責務へ進みます。

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

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

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

学習コースから次を選ぶ