大网数据广告活动
数据库部署与 SQL 参考

TiDB 中文参考:SHOW [BACKUPS|RESTORES]

· 52CE 我爱测

# SHOW [BACKUPS|RESTORES] 语句会列出所有在 TiDB 实例上队列中的、正在执行的和近期完成的 和 任务。 查询 任务时,使用 语句。查询 任务时,使用 语句。 执行 需要 或 权限。执行 需要 或 权限。 不显示用 命令行工具启动的备份和恢复。 ## 语法图 ## 示例 在一个连接中,执行以下命令备份数据库: 在备份完成之前,在新的连接中执行 : 输出结果的第一行描述如下: | 列名 | 描述 | | :---

SHOW [BACKUPS|RESTORES]

SHOW [BACKUPS|RESTORES] 语句会列出所有在 TiDB 实例上队列中的、正在执行的和近期完成的 BACKUP 和 RESTORE 任务。

查询 BACKUP 任务时,使用 SHOW BACKUPS 语句。查询 RESTORE 任务时,使用 SHOW RESTORES 语句。

执行 SHOW BACKUPS 需要 SUPER 或 BACKUP_ADMIN 权限。执行 SHOW RESTORES 需要 SUPER 或 RESTORE_ADMIN权限。

不显示用 br 命令行工具启动的备份和恢复。

语法图

ShowBRIEStmt ::=
    "SHOW" ("BACKUPS" | "RESTORES") ShowLikeOrWhere?

ShowLikeOrWhere ::=
    "LIKE" SimpleExpr
|   "WHERE" Expression

示例

在一个连接中,执行以下命令备份数据库:

BACKUP DATABASE `test` TO 's3://example-bucket/backup-01/';

在备份完成之前,在新的连接中执行 SHOW BACKUPS:

SHOW BACKUPS;
+--------------------------------+---------+----------+---------------------+---------------------+-------------+------------+---------+
| Destination                    | State   | Progress | Queue_time          | Execution_time      | Finish_time | Connection | Message |
+--------------------------------+---------+----------+---------------------+---------------------+-------------+------------+---------+
| s3://example-bucket/backup-01/ | Backup  | 98.38    | 2020-04-12 23:09:03 | 2020-04-12 23:09:25 |        NULL |          4 | NULL    |
+--------------------------------+---------+----------+---------------------+---------------------+-------------+------------+---------+
1 row in set (0.00 sec)

输出结果的第一行描述如下:

列名 描述
Destination 目标存储的 URL(为避免泄露密钥,所有参数均不显示)
State 任务状态
Progress 当前状态的进度(百分比)
Queue_time 任务开始排队的时间
Execution_time 任务开始执行的时间;对于队列中任务,该值为 0000-00-00 00:00:00
Finish_time 任务完成的时间戳;对于队列中的和运行的任务,该值为 0000-00-00 00:00:00
Connection 运行任务的连接 ID
Message 详细信息

可能的状态有:

状态 说明
Backup 进行备份
Wait 等待执行
Checksum 运行 checksum 操作

连接 ID 可用于在 KILL TIDB QUERY 语句中取消备份/恢复任务:

KILL TIDB QUERY 4;
Query OK, 0 rows affected (0.00 sec)

过滤

在 LIKE 子句中使用通配符,可以按目标存储 URL 筛选任务:

SHOW BACKUPS LIKE 's3://%';

使用 WHERE 子句,可以按列筛选任务:

SHOW BACKUPS WHERE `Progress` < 25.0;

MySQL 兼容性

该语句是 TiDB 对 MySQL 语法的扩展。

另请参阅

本文来自 PingCAP / TiDB 文档贡献者,按 CC BY-SA 3.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
PingCAP / TiDB 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY-SA 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。