ti db create-db-cluster-branch

为一个 TiDB Cloud Starter 实例创建分支。--wait 会等待分支变为 ACTIVE。该命令会在创建分支前验证父集群是否为 Starter。

语法

ti db create-db-cluster-branch
  --db-cluster-branch-name <string>
  --db-cluster-id <string>
  [--dry-run]
  [--help]
  [--version]
  [--wait]

选项

• --db-cluster-branch-name <string>：Starter DB 集群分支显示名称。[必需]
• --db-cluster-id <string>：Starter DB 集群 ID。[必需]
• --dry-run：验证请求而不应用更改。
• --help：显示帮助信息。
• --version：显示版本信息。
• --wait：等待创建的分支变为 ACTIVE 后再返回。

有关所有命令共享的选项，请参见全局选项。

示例

• 创建一个分支并等待其变为活动状态：

  # Wait until the new database branch can accept connections.
  ti db create-db-cluster-branch --db-cluster-id "<cluster-id>" --db-cluster-branch-name dev --wait
  

• 预览分支创建：

  # Validate the parent cluster and branch request without creating it.
  ti db create-db-cluster-branch --db-cluster-id "<cluster-id>" --db-cluster-branch-name preview --dry-run
  

相关文档

• TiDB Cloud Starter CLI 命令参考