跳到主要内容

关系型数据库（MySQL）

v3.0.0+

tcb db MySQL 系列命令自 v3.0.0 起提供。

tcb db 命令集合提供对 CloudBase MySQL 数据库的实例管理、SQL 执行、备份回档和慢查询监控能力。

tcb db execute​

执行 SQL 语句（最常用命令）。

tcb db execute --sql '<sql>' [options]

参数​

参数说明默认值
-s, --sql <sql>要执行的 SQL 语句—
--readOnly以只读模式执行（适合查询，防止误操作）false
--instanceId <id>实例 ID（多实例时指定）—
-e, --env-id <envId>环境 ID—
--json输出 JSON—

示例​

# 查询（只读模式）
tcb db execute --sql 'SELECT * FROM users LIMIT 10' --readOnly -e my-env-id

# 写入操作
tcb db execute --sql "INSERT INTO orders (user_id, amount) VALUES (1, 99.9)" -e my-env-id

# 查询指定实例
tcb db execute --sql 'SHOW TABLES' --instanceId inst-xxx --readOnly -e my-env-id

tcb db instance list​

列出当前环境下的 MySQL 实例。

tcb db instance list [options]

参数​

参数说明默认值
--limit <n>返回数量20
--offset <n>偏移量0
--instanceId <id>按实例 ID 过滤—
-e, --env-id <envId>环境 ID—

tcb db instance config​

查询或修改 MySQL 实例配置（变配）。

# 查询实例配置
tcb db instance config --instanceId <id> [options]

# 修改实例配置（变配）
tcb db instance config --instanceId <id> --cpu <n> --memory <gb> [options]

参数​

参数说明可选值
--instanceId <id>实例 ID—
--cpu <n>CPU 核数1 / 2 / 4 / 8 / 16
--memory <gb>内存大小（GB）2 / 4 / 8 / 16 / 32 / 64 / 128

tcb db instance restart​

重启 MySQL 实例。

tcb db instance restart --instanceId <id> [options]

备份管理​

tcb db backup create​

创建 MySQL 备份。

tcb db backup create [options]
参数说明必填
--type <type>备份类型：snapshot（快照）/ logic（逻辑备份）—
--databases <names>要备份的数据库列表，逗号分隔（仅逻辑备份有效）—
--name <name>备份备注名—
--instanceId <id>实例 ID—
# 创建快照备份
tcb db backup create --type snapshot --name "发布前备份" --instanceId inst-xxx -e my-env-id

# 逻辑备份指定数据库
tcb db backup create --type logic --databases "db1,db2" --instanceId inst-xxx -e my-env-id

tcb db backup list​

列出备份记录。

tcb db backup list [--startTime <time>] [--endTime <time>] [options]

tcb db backup restore​

恢复备份（集群回档）。

tcb db backup restore [options]
参数说明必填
--strategy <strategy>回档策略：snapRollback（按备份）/ timeRollback（按时间点）✅
--backupId <id>备份文件 ID（按备份回档时必填）按情况
--expectTime <time>期望回档时间（按时间点时必填，格式：2026-03-10 14:00:00）按情况
--instanceId <id>实例 ID—
# 按备份 ID 回档
tcb db backup restore \
  --strategy snapRollback \
  --backupId backup-xxx \
  --instanceId inst-xxx \
  -e my-env-id

# 按时间点回档
tcb db backup restore \
  --strategy timeRollback \
  --expectTime "2026-03-10 14:00:00" \
  --instanceId inst-xxx \
  -e my-env-id

tcb db backup delete​

删除指定备份。

tcb db backup delete --backupId <id> [options]

慢查询监控​

tcb db monitor slow-log​

查看慢查询日志，支持时间范围和多维度过滤。

tcb db monitor slow-log [options]
参数说明
--start <time>开始时间（如 2026-03-01 00:00:00）
--end <time>结束时间
--threshold <seconds>慢查询阈值（秒），本地过滤，如 1
--orderBy <field>排序字段：QueryTime / LockTime / RowsExamined / RowsSent
--orderByType <order>排序方式：asc / desc
--database <name>按数据库名过滤
--username <name>按用户名过滤
--instanceId <id>实例 ID
-e, --env-id <envId>环境 ID
# 查看过去 24h 的慢查询，按耗时降序
tcb db monitor slow-log \
  --start "2026-03-29 00:00:00" \
  --end "2026-03-30 00:00:00" \
  --orderBy QueryTime \
  --orderByType desc \
  --threshold 1 \
  -e my-env-id