管理 TiDB Cloud 分支
本文档介绍如何使用 TiDB Cloud 控制台 管理你的 TiDB Cloud Starter 实例的分支。若需使用 TiDB Cloud CLI 进行管理，请参见 ticloud branch。
所需权限
- 若要创建分支或连接到分支，你必须是组织的
Organization Owner角色或目标项目的Project Owner角色。 - 若要查看项目中集群的分支，你必须属于该项目。
关于权限的更多信息，请参见 用户角色。
创建分支
创建分支，请按照以下步骤操作：
在 TiDB Cloud 控制台中，进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
在左侧导航栏点击 Branches。
在 Branches 页面右上角，点击 Create Branch。此时会弹出对话框。
或者，你也可以从已有的父分支创建分支，找到目标父分支所在行，然后点击 ... > Create Branch（在 Action 列）。
在 Create Branch 对话框中，配置以下选项：
- Name：输入分支名称。
- Parent branch：选择原始 TiDB Cloud Starter 实例或已有分支。
main代表当前实例。 - Include data up to：选择以下之一：
- Current point in time：从当前状态创建分支。
- Specific date and time：从指定时间点创建分支。
点击 Create。
根据你的 TiDB Cloud Starter 实例中的数据量，分支创建将在几分钟内完成。
查看分支
要查看 TiDB Cloud Starter 实例的分支，请按照以下步骤操作：
在 TiDB Cloud 控制台中，进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
在左侧导航栏点击 Branches。
TiDB Cloud Starter 实例的分支列表会显示在右侧面板。
连接到分支
要连接到分支，请按照以下步骤操作：
- 在 TiDB Cloud 控制台中，进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
- 在左侧导航栏点击 Branches。
- 在目标分支所在行的 Action 列，点击 ...。
- 在下拉列表中点击 Connect。此时会弹出连接信息对话框。
- 点击 Generate Password 或 Reset Password，以创建或重置 root 密码。
- 使用连接信息连接到该分支。
另外，你也可以在 TiDB Cloud Starter 实例的概览页面获取连接字符串：
- 在 TiDB Cloud 控制台中，进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
- 在右上角点击 Connect。
- 在
Branch下拉列表中选择你要连接的分支。 - 点击 Generate Password 或 Reset Password，以创建或重置 root 密码。
- 使用连接信息连接到该分支。
删除分支
要删除分支，请按照以下步骤操作：
- 在 TiDB Cloud 控制台中，进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
- 在左侧导航栏点击 Branches。
- 在目标分支所在行的 Action 列，点击 ...。
- 在下拉列表中点击 Delete。
- 确认删除操作。
重置分支
重置分支会将其与父分支的最新数据进行同步。
要重置分支，请按照以下步骤操作：
- 在 TiDB Cloud 控制台中，进入 My TiDB 页面，然后点击目标 TiDB Cloud Starter 实例的名称，进入其概览页面。
- 在左侧导航栏点击 Branches。
- 在目标分支所在行的 Action 列，点击 ...。
- 在下拉列表中点击 Reset。
- 确认重置操作。