RECOVER TABLE

RECOVER TABLE 的功能是恢复被删除的表及其数据。在 DROP TABLE 后，在 GC life time 时间内，可以用 RECOVER TABLE 语句恢复被删除的表以及其数据。

语法

RECOVER TABLE table_name

RECOVER TABLE BY JOB JOB_ID

语法图

RecoverTableStmt ::=
    'RECOVER' 'TABLE' ( 'BY' 'JOB' Int64Num | TableName Int64Num? )

TableName ::=
    Identifier ( '.' Identifier )?

Int64Num ::= NUM

NUM ::= intLit

注意事项

如果删除表后并过了 GC lifetime，就不能再用 RECOVER TABLE 来恢复被删除的表了，执行 RECOVER TABLE 语句会返回类似错误：snapshot is older than GC safe point 2019-07-10 13:45:57 +0800 CST。

示例

• 根据表名恢复被删除的表。

  DROP TABLE t;
  

  RECOVER TABLE t;
  

  根据表名恢复被删除的表需满足以下条件：

  • 最近 DDL JOB 历史中找到的第一个 DROP TABLE 操作，且
  • DROP TABLE 所删除的表的名称与 RECOVER TABLE 语句指定表名相同

• 根据删除表时的 DDL JOB ID 恢复被删除的表。

  如果第一次删除表 t 后，又新建了一个表 t，然后又把新建的表 t 删除了，此时如果想恢复最开始删除的表 t，就需要用到指定 DDL JOB ID 的语法了。

  DROP TABLE t;
  

  ADMIN SHOW DDL JOBS 1;
  

  上面这个语句用来查找删除表 t 时的 DDL JOB ID，这里是 53：

  +--------+---------+------------+------------+--------------+-----------+----------+-----------+-----------------------------------+--------+
  | JOB_ID | DB_NAME | TABLE_NAME | JOB_TYPE   | SCHEMA_STATE | SCHEMA_ID | TABLE_ID | ROW_COUNT | START_TIME                        | STATE  |
  +--------+---------+------------+------------+--------------+-----------+----------+-----------+-----------------------------------+--------+
  | 53     | test    |            | drop table | none         | 1         | 41       | 0         | 2019-07-10 13:23:18.277 +0800 CST | synced |
  +--------+---------+------------+------------+--------------+-----------+----------+-----------+-----------------------------------+--------+
  

  RECOVER TABLE BY JOB 53;
  

  根据删除表时的 DDL JOB ID 恢复被删除的表，会直接用 DDL JOB ID 找到被删除表进行恢复。如果指定的 DDL JOB ID 的 DDL JOB 不是 DROP TABLE 类型，会报错。

原理

TiDB 在删除表时，实际上只删除了表的元信息，并将需要删除的表数据（行数据和索引数据）写一条数据到 mysql.gc_delete_range 表。TiDB 后台的 GC Worker 会定期从 mysql.gc_delete_range 表中取出超过 GC lifetime 相关范围的 key 进行删除。

所以，RECOVER TABLE 只需要在 GC Worker 还没删除表数据前，恢复表的元信息并删除 mysql.gc_delete_range 表中相应的行记录就可以了。恢复表的元信息可以用 TiDB 的快照读实现。具体的快照读内容可以参考读取历史数据文档。

TiDB 中表的恢复是通过快照读获取表的元信息后，再走一次类似于 CREATE TABLE 的建表流程，所以 RECOVER TABLE 实际上也是一种 DDL。

MySQL 兼容性

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