开源项目 db-branch 可在自有服务器上为 MySQL 和 PostgreSQL 创建数据库分支,并通过内置 MCP 服务器让 AI 智能体自行创建、查询和删除分支。据项目说明,智能体可以在分支中执行有风险的查询或迁移,不触及生产数据;同一工具也可用于迁移测试,以及为每个拉取请求提供独立数据库。
db-branch 将已装载数据库的 ZFS 数据集作为「基底」,再从基底快照克隆出分支。分支采用写时复制机制,创建时不复制数据,每个分支运行自己的数据库服务,并使用独立端口。
据发布方在自有 3 节点测试集群上的自测,PostgreSQL 分支约 0.5 秒就绪,MySQL 分支约 3 秒就绪,创建时复制的数据量为 0 字节。这些耗时对应项目方的测试环境。
分支创建后,branch reset 可将其恢复到创建时的状态,--ttl 则用于到期自动删除。需要保留中间状态时,可通过 branch checkpoint 即时保存运行中分支的状态,再用 branch restore 恢复。恢复会替换当前状态,已有检查点仍可用于后续恢复。
版本升级也以分支为单位:branch upgrade 可将单个分支升级到更新的 MySQL 或 PostgreSQL 版本,基底及其他分支保持原状。工具会在升级前自动保存检查点,失败时自动回滚;--check-only 可先检查升级会遇到的问题。多个数据库引擎版本可以并存。
CLI、REST API、网页控制台与 MCP 服务器共用同一套 API。部署方式支持单节点或 Raft 集群,还可选用 ProxySQL,按用户名或查询注释将连接路由到对应分支。
项目目前处于 Beta 阶段,作者提醒,1.0 之前 API 和命令行细节仍可能变化。核心部分以 Apache-2.0 开源,采用自托管方式,没有托管或云版本。认证与 SSO、审计、历史、差异对比及 FSx 存储属于独立的闭源付费模块,需要按月或按年的许可证密钥启用。
运行环境要求 Ubuntu 24.04 LTS 或 26.04 LTS,以及 ZFS 存储池。Mac 和 Windows 用户可通过 Multipass 创建 Ubuntu 虚拟机试用,项目方给出的准备时间约为 2 分钟。项目还提供浏览器控制台演示,演示完全在页面内运行,不会创建真实资源。