結論から言うと、db-branchはAIエージェントやCIに本番相当のデータベースを触らせたいチーム向けの、セルフホスト型データベース分岐ツールです。ZFSのコピーオンライトを使い、MySQL / PostgreSQLのBranchを数秒で作成します。公式サイトでは3ノード試験クラスターでPostgreSQL約0.5秒、MySQL約3秒、作成時コピー0Bと説明されています。Claude CodeなどのエージェントにSQLやマイグレーションを試させる前に、5項目だけ確認すると導入判断がしやすくなります。
db-branchで何が変わる?まず見るべき5項目
確認すべきなのは、1. 本番データを外に出さずに検証できるか、2. PRごとにDB Branchを発行できるか、3. AIエージェントが専用Branchだけを操作できるか、4. リセットとTTLで後片付けできるか、5. 監査やSSOが必要な組織で有償モジュールまで見込むか、の5点です。単なるテストDB作成ツールではなく、危険なSQL・スキーマ変更・AI生成コードを隔離環境に閉じ込めるための運用部品として見るのが現実的です。
公式情報で確認できる主要スペック
公式GitHubと日本語サイトで確認できる範囲では、db-branchはBetaで、1.0までにAPIやCLIの詳細が変わる可能性があります。コアはApache-2.0のオープンソースで、MySQLとPostgreSQLに対応します。動作環境はUbuntu 24.04 LTSまたは26.04 LTS、ZFSプールが前提です。試験済みデータベースとしてMySQL 8.0 / 8.4、PostgreSQL 18が挙げられています。
BranchはBaseのSnapshotをZFSでCloneしたものです。作成時にはデータ全体をコピーせず、Branchが書き込んだブロック分だけ容量が増えます。公式の試験値では、PostgreSQL Branchが約0.5秒、MySQL Branchが約3秒で接続可能になり、作成時にコピーするデータは0Bです。この数字は3ノード試験クラスターでの測定値なので、自社環境ではPoCで再測定する前提にしてください。
AIエージェント運用で効く理由
db-branchの特徴は、CLI・REST API・Web Consoleに加えてMCP Serverを備えている点です。公式READMEでは、LLMエージェントが自分用のBranchを作り、危険なクエリやマイグレーションを実行し、最後にBranchを削除できると説明されています。本番DBに直接触れさせない設計にしやすいので、AIコーディング導入時の事故範囲を小さくできます。
PRごとのデータベースをどう設計するか
公式サイトには、GitHub ActionsからREST APIを呼び、Pull Requestを開いたときにBranchを作り、閉じたときに削除する例があります。closeイベントを取り逃してもTTLで自動削除できるため、使い捨てDBが残り続けるリスクを下げられます。CIのself-hosted runnerからクラスターのポート7080へ届くこと、トークンをSecretに保存すること、branches用トークンに権限を絞ることが実装時の基本になります。
料金とライセンスで注意する点
CommunityはFree / Open sourceで、Base、Snapshot、Branch、Checkpoint、Branch upgrade、Anonymous branch、定期更新、無料マスキング、クラスター、Console、CLI、API、MCPを含むと公式プランページにあります。Liteは月30ドルまたは年300ドル、日本の事業者向けには月3,000円または年30,000円で、MySQLの変更履歴と任意時点復元が中心です。TeamとBusinessは後日提供予定で、BusinessにはSSOや監査ログが予定されています。
30日PoCの進め方
PoCは30日で十分に切れます。1週目はMultipassか検証用Ubuntuで小さなBaseを作り、Branch作成・reset・deleteの所要時間を測ります。2週目はPRごとにBranchを作るCIを1リポジトリだけに入れます。3週目はAIエージェントに読み取り・マイグレーション・テスト修正をBranch限定で実行させ、失敗時のリセット手順を固めます。4週目はマスキング、TTL、通知、バックアップ、権限分離を確認し、継続利用するか判断します。
導入前のリスクと回避策
最大の注意点は、Branchが簡単に作れるほどデータの扱いが雑になりやすいことです。本番データをBaseにするなら、マスク済みBaseを標準にし、AIエージェントにはBranch専用の認証情報だけを渡します。BranchのTTLを必須化し、長期保存が必要な場合はCheckpointや履歴機能の対象を明確にします。さらに、ZFSとDBランタイムの運用知識が必要なので、アプリチームだけでなくインフラ担当をPoC初期から入れるべきです。
FAQ
Q. db-branchはクラウドサービスですか? A. 公式READMEでは、hosted/cloud versionはないと説明されています。自社サーバーや自社管理のUbuntu環境に入れて使うセルフホスト型です。
Q. AIエージェントなしでも使えますか? A. 使えます。PRごとのDB、マイグレーション検証、バージョンアップの事前確認、テストデータのリセットなど、通常の開発・CI用途が中心です。MCPはAIエージェントにBranch操作を渡したい場合の追加価値です。
Q. すぐ本番導入してよいですか? A. Betaであること、APIやCLIが1.0までに変わる可能性があることを踏まえ、まずは検証環境と補助CIで試すのが現実的です。監査・SSO・権限分離が必須なら、公式の有償モジュール予定と自社ログ設計を合わせて確認してください。
AIエージェントにDB操作を任せるなら、プロンプトの注意書きだけでなく、壊してよいBranch、短いTTL、マスク済みBase、実行ログまでセットで設計する必要があります。HelloCraftAIでは、AI開発チーム向けのPoC設計、エージェント権限制御、CI/CDへの組み込み方を整理できます。 導入相談はこちら