在三节点测试集群中,db-branch 可以在约 0.5 秒内创建一个 PostgreSQL 数据库分支,并在约 3 秒内创建一个 MySQL 分支。这些操作涉及 0 字节的数据复制,因为系统利用 ZFS 写时复制(CoW)技术来创建基础数据集的克隆。

演示创建数据库分支、删除表、重置分支并将其删除的过程。
db-branch 工作流演示,展示数据库分支的创建、操作和删除。github.com

此 GIF 展示了 db-branch 的核心功能,包括分支创建和生命周期管理。

写时复制分支机制

db-branch 的核心架构依赖于 ZFS 数据集。一个“基础(base)”是包含已加载数据库的 ZFS 数据集,而一个“分支(branch)”是该基础快照的 ZFS 克隆。由于 ZFS 克隆是写时复制的,无论数据库大小如何,分支的初始创建几乎是瞬时的。

显示数据库分支与其父基础之间关系的视觉图表。
展示系统中数据库克隆血缘关系和层级的分支图表。github.com

分支图直观地展示了如何使用 ZFS 写时复制技术从基础数据集派生出克隆。

每个分支都在唯一的端口上运行自己的数据库服务器。为了简化应用程序访问,系统可以使用 ProxySQL 路由,根据用户名或特定的查询注释将客户端连接定向到正确的分支。

db-branch Web 控制台界面的分支页面。
用于管理和查看活动数据库分支的 Web 控制台界面。github.com

Web 控制台为管理系统创建的各种数据库分支提供统一界面。

“db-branch 在几秒钟内创建一个大型数据库的写时复制分支,且没有任何数据被复制。”

— GitHub - db-branch/db-branch: Instant MySQL database branches on ZFS clones, clustered across VMs with ProxySQL routing

AI 代理和 CI/CD 的使用案例

db-branch 专门设计用于解决开发中的“共享”数据库环境问题。它允许进行“每个拉取请求(per-pull-request)”的数据库复制,其中每个 CI 运行都会获得一个全新的、隔离的副本,并在设定的生存时间(TTL)后自动删除。

对于 AI 代理,该项目包含内置的 MCP(Model Context Protocol)服务器。这使得 LLM 代理能够自主创建分支、执行高风险查询或迁移,然后删除分支,确保在代理操作期间生产数据保持未受影响。

版本管理和集群架构

该系统支持同时运行多个版本的 MySQL 和 PostgreSQL。用户可以在特定分支上执行“仅检查”升级,以在将升级应用于基础或其他分支之前识别潜在问题。

分支创建速度: PostgreSQL 分支 0.5 s; MySQL 分支 3 s
分支创建速度github.com

由 HN Digest 根据 github.com 报告的数据绘制;数值按原文显示。

该软件作为虚拟机组成的 Raft 集群运行,在节点之间共享基础、分支和设置。虽然核心项目采用 Apache-2.0 许可,但某些高级功能如 SSO、审计和历史记录作为独立的闭源模块提供。

部署要求和限制

db-branch 是一个自托管解决方案,不提供托管云版本。它需要 Linux 环境(特别是 Ubuntu 24.04 或 26.04 LTS)和 ZFS 池才能运行。

由于系统依赖于 ZFS 特有的功能,它不兼容不支持 ZFS 克隆的标准云原生存储卷。此外,虽然核心是开源的,但该项目在特定企业功能上混合使用了开源和闭源模块。

Hacker News 读者的反应

  • 亲身经验: 一位评论者分享了他们最近在工作场所设置类似系统的实际经验,旨在提供廉价的数据库克隆。 评论 ↗
  • 技术补充: 一位评论者要求澄清该项目是利用 Postgres 18 中的原生 file_copy_method 还是使用自定义实现。 评论 ↗
  • 疑问: 一位用户提出了一个重要问题,即是否可以将创建的分支中的更改合并回官方副本。 评论 ↗

以上为 Hacker News 讨论中观点的摘要,并非经过核实的事实。 阅读完整讨论 ↗