文档中心

云数据库 TiDB 版

分支管理

创建分支

集群分支是从集群分叉出来的数据副本，每个分支都是一个独立的集群。它提供了一个隔离的环境，使您可以自由地进行实验，而无需担心影响源集群。通过分支，开发者可以并行工作、快速迭代新功能、排查问题而不影响生产数据库，并且在需要时可以轻松回滚更改。该功能简化了开发和部署流程，同时确保生产数据库具有高稳定性和可靠性。

本文介绍如何创建分支。

背景信息

实现方式

创建分支会使分支中的数据会在某一特定时间点与源集群或其父分支的数据分叉。在父分支或分支中所做的更改将不会相互同步。

云数据库 TiDB 版采用写时复制（Copy-on-Write）技术，通过源集群与分支间的数据共享，实现快速、无感的分支创建。整个过程通常在数分钟内完成，不影响源集群性能。

适用场景

在以下场景中，分支非常有用，适用于多个开发者或团队需要独立工作、测试更改、修复 bug、尝试新功能或发布更新而不影响生产数据库的情况。

功能开发：开发者可以在隔离环境中开发新功能，而不会影响生产数据库。每个功能都可以有自己的分支，实现快速迭代和实验，而不会影响其他正在进行的工作。

Bug 修复：开发者可以为特定 bug 创建专用分支，测试修复方案，并在验证后合并回去，而不会给生产数据库引入新的问题。

实验：在开发新功能或进行更改时，开发者可以创建分支，尝试不同的方法或配置。这使他们能够比较各种选项，收集数据，并在更改合并到生产数据库前做出明智决策。

性能优化：有时会对数据库进行更改以提升性能。通过分支，开发者可以在隔离环境中实验和微调各种配置、索引或算法，以找出最优解。

测试与预发布：团队可以为测试和预发布目的创建分支。它为质量保证、用户验收测试或上线前的定制化提供了受控环境。

并行开发：不同团队或开发者可以同时进行独立项目开发。每个项目都可以有自己的分支，实现独立开发和实验，同时仍可将更改合并回生产数据库。

注意事项

集群分支会创建到与源集群相同的地域，且无法为大于 100 GiB 的 Essential 集群创建分支。

若源集群包含 TiFlash 副本，在创建新分支后，这些副本会在新分支中暂时不可用，因为 TiFlash 需要重建副本数据。

分支主要用于短期功能开发和功能测试。由于分支不具备自动扩缩容能力，不适合用于性能测试。

每个分支为独立的集群，因此无法复用源集群连接，创建分支后需要单独与分支建立连接。如何连接到分支，详情请参见连接分支。

操作步骤

登录云数据库 TiDB 版控制台。

在顶部菜单栏，选择集群所属的项目和地域。

在集群列表页面，单击目标集群名称。

在左侧导航栏单击分支，进入分支页面。

单击创建分支，在弹窗中配置如下参数：

参数	说明
名称	输入分支名称。
父分支	选择当前集群或已有集群分支作为数据源。main 代表当前集群。
包含数据截至	当前时间节点：从当前时间点创建分支。指定日期和时间：从指定时间点创建分支。说明您可以选择最近 14 天内的任意时间点。

单击创建。

说明

分支创建时长与源集群数据量大小有关，通常在几分钟内完成。当分支状态由 Creating 变为 Active，表示分支创建完成。

最近更新时间：2026.08.20 14:51:29

这个页面对您有帮助吗？

有用

无用