SHOW [BACKUPS|RESTORES]

这些语句会显示在 TiDB 实例上执行的所有已排队、正在运行以及最近完成的 BACKUP 和 RESTORE 任务的列表。

这两个语句都需要 SUPER 权限才能执行。

使用 SHOW BACKUPS 查询 BACKUP 任务，使用 SHOW RESTORES 查询 RESTORE 任务。

通过 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)

上面结果的第一行描述如下：

可能的状态有：

可以使用连接 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 语法的扩展。

参见

• BACKUP
• RESTORE