Umbrachyx

闇は、光より速い。
過去を覚えているデータベース。

データが書き換わっていた。いつ、誰が、なぜ、を誰も言えない。
ここでは、すべての変更が、誰が・なぜ・誰が承認したかと一緒に残ります。
書き込みが続く間も、読み取りは数十マイクロ秒で返ります。

いまの値が光なら、履歴は、光が届く前からそこにある影です。

Docker で始める GitHub Linux / macOS / Windows・MIT
端末の画面。AI エージェントの変更の差分で、1 人だけ 50 個になっている。直した変更が、承認した人の名前つきで統合される。そのあと、その値の履歴に、変更ごとの「誰が・なぜ・誰が承認したか」が並ぶ。
あとから値に聞けば、誰が・なぜ・誰が承認したかが返ります。AI エージェントが最初に書いた 50 個は、本番に届いていません。エージェントの書き込みは、人が差分を読んで承認するまで枝で待つからです。コマンドと出力は事例「ゲームの所持品」を縮めたものです。事例は、変更のたびに試験が書いてあるとおりに実行しています(確定の id は実行ごとに変わります)。

なぜそれが起きるのか

データベースは「いまの値」だけを持ち、書き込みはその場で本番になる。 過去を持つと遅くなるので、ログとバックアップに任せてきた → そこへ AI エージェントも書くようになった。速くて、数が多くて、ときどき間違える → 気づいたときには、元の値も理由も残っていない。

ここでは、履歴はデータの横に置くログではなく、データの持ち方そのものです。メモリの上にあるので、値に「どこから来たか」を聞く費用は、値を読む費用とほぼ同じです。 また、権限を設定で狭める方法は、設定を 1 つ誤れば抜けます。そこで、エージェントは本番に書く口をそもそも持ちません。 エージェントに渡すトークンには枝の名前が入っていて、その枝のほかには書けず、承認もできません(例外は、過去を持たないと宣言したテーブルだけです。枝が無いので、トークンが決めるのはどのキーに書けるかだけです)。 乗っ取られたエージェントに何ができないかは、試験つきの一覧にしてあります。

Umbrachyx とは

Umbrachyx は、すべての変更を履歴として持つインメモリのデータベースです。 値の 1 つ 1 つが、いつ・何から何へ・誰が・なぜ・誰が承認したかを持ちます。その履歴は、git がファイルを扱うように、枝を分け、差分を見て、統合し、取り消せます。Redis のプロトコルで話すので、いまあるクライアントがそのまま使えます。エージェントは MCP でつながります。

答えられるようになる問い

手順つきの見本が 4 つあります(英語):ゲームの所持品、サポート窓口、設定の段階的な反映、ゲームのデータへの 5 つの問い。どれも、書いてあるコマンドを試験がそのまま実行しています。

架空の例で見る、使いどころ

実在の利用者の話ではありません。3 つとも作った例で、データも作りものです。どれも手順の文書になっていて、書いてあるコマンドを試験がそのまま流しています。

速さ —— 負けた行も同じ表に

AWS の同じ機械(EC2 m6id.xlarge・東京・ローカル NVMe)で、Valkey と並べて測りました。どちらも、書き込みをディスクに同期してから確定を返す設定です(Valkey は appendfsync always)。値は 32 バイト、キーは 100 万個、データは合成です。

1 秒あたり Umbrachyx Valkey
50 クライアントが書き続けている間の読み取り 24,667 1,758 約 14 倍
読み取り・1 クライアント 54,377 37,216 約 1.5 倍
同期つきの書き込み・1 クライアント 8,832 6,268 約 1.4 倍
読み取り・50 クライアント 149,477 151,745 1% 少ない
同期つきの書き込み・64 クライアント 43,649 94,473 約 2.2 分の 1
同期つきの書き込み・256 クライアント 56,577 112,360 約 2.0 分の 1
同期つきの書き込み・50 クライアントが 64 個ずつ送る 84,221 626,959 約 7.4 分の 1
上書き 1 回あたりのメモリ 約 655 バイト 約 16 バイト 約 40 倍使う

どの行も、2026-11-17 に 3 回測った中央値です。Umbrachyx の行は、履歴を全部持ったうえでの数字です。速い Valkey ではありません。多くのクライアントが同時に書く使い方と、メモリの量では、はっきり負けています。履歴を全部持つための費用です。生の出力・機械・手順は bench/results に、PostgreSQL・Dolt との比較を含む全部の表は README にあります。

過去を持たないテーブル

テーブルごとに、Valkey と同じく「いまの値だけを持つ」と宣言できます。履歴・枝・確認はありません。plain は、書き込みをディスクに同期してから返事をします(Valkey の appendfsync always と比べます)。plain-async は、先に返事をして 1 秒以内に同期します(Valkey の既定の appendfsync everysec と比べます)。

1 秒あたり plain Valkey always plain-async Valkey everysec
読み 95%・書き 5%、50 クライアント 162,179 81,269 170,792 106,042
読み 50%・書き 50%、50 クライアント 124,003 72,454 156,246 100,182
書き込み・1 クライアント 10,680 6,268 29,061 34,554
書き込み・64 クライアント 90,050 94,473 106,838 156,495
書き込み・50 クライアントが 64 個ずつ送る 540,687 626,959 572,082 638,570

同じ機械・同じ日の数字です。読みが混ざる負荷では、どちらの型も Valkey より多くさばきます。書き込みだけでは、plain-async はどの行でも負け、plain は 64 クライアント以上で負けています。500 万回書いたあとの再起動は、plain で 3.3 秒、履歴つきで 57.5 秒です。

壊れにくさ

変更が本番に入るまで

dbboard と一緒に使う

dbboard は、同じ作者のデスクトップ用データベースビューアです。Redis のサーバーにつなぐのと同じやり方で umbrachyx serve につながり、端末のコマンドが返すものを画面で見せます。

dbboard だけの仕掛けはありません。履歴は Redis のプロトコルの上の UMBRA.* コマンドで聞くので、そのプロトコルを話すクライアントなら何からでも送れます。

向かう先

始まりは、すべての値の履歴と、メモリの速さです。 向かう先は、AI のエージェントが「ここで働きたい」と選ぶデータベースです。 エージェントは会話をまたいだ記憶を持たず、少し前に読んだ値から計算して書き、時間切れで送り直し、読んだぶんだけ文脈を使います。だから、ものさしは 1 秒あたりの件数よりも、「読んで、試して、確かめる 1 往復が安いか」と、間違いが安いかです。

人がデータベースに求めるものは、過去の経験が教えたものです。履歴を残すこと、速いこと、それを 1 秒あたりの件数で数えること。この製品はまずそこで測られ、上の表がその結果です。2 つ目のものさしは、この製品を一緒に作っている AI のエージェントから出てきました。このページを書くように頼まれたエージェントは、誰も見ていない書き込みと、間違えても何も壊さない枝から書き始めました。理由を聞かれて、「書くのは自分だから」と答えています。ものさしは 2 つとも持ち続けます。古いほうは「どれだけ速いか」を、新しいほうは「エージェントがどれだけ安く正しい答えに着くか」を測ります。

次に入るもの(この順)

  1. 過去を持たないテーブルの、書き込みの速さ。多くのクライアントが書くだけの負荷では、まだ Valkey に負けています。
  2. エージェントのトークンを確かめる費用を、書き込みごとに安くする。
  3. ログが増え続けないようにする。上書きされた分を落とす、履歴を持つ期間を決める、キーに期限を付ける。
  4. 読み取り専用の台をほかの機械に置くことと、バックアップの道具。
  5. エージェントの前提を付けた書き込み(「まだ 3 なら 8 にする」)と、2 回送っても 1 回になる書き込み。

日付は書きません。順番は、測った結果で入れ替わることがあります。いま手を付けているものは Issue に、版ごとに入ったものは リリースのページにあります。

全部の一覧は構想(英語)に、このサイトを読むエージェント向けには llms.txt があります。

始め方

サーバーだけを Docker で立てます。ログはボリュームに置かれます。イメージは amd64 と arm64 用です。版ごとの中身は リリースのページにあります。

$ docker run -d --name umbrachyx -p 127.0.0.1:6380:6380 -v umbrachyx-data:/data ghcr.io/meta-taro/umbrachyx
$ valkey-cli -p 6380 set player/42/gems 100
OK
$ valkey-cli -p 6380 umbra.history app player/42/gems
# 値・確定の id・時刻・誰が・なぜ・誰が承認したか が JSON で返る

よくある質問

まだ出来ていないこと