title	summary
FLASHBACK DATABASE	TiDB 数据库中 FLASHBACK DATABASE 的使用概况。

FLASHBACK DATABASE

TiDB v6.4.0 引入了 FLASHBACK DATABASE 语法，其功能是在 Garbage Collection (GC) life time 时间内，可以用 FLASHBACK DATABASE 语句来恢复被 DROP 删除的数据库以及数据。

可以使用系统变量 tidb_gc_life_time 配置数据的历史版本的保留时间（默认值是 10m0s）。可以使用以下 SQL 语句查询当前的 safePoint，即 GC 已经清理到的时间点：

SELECT * FROM mysql.tidb WHERE variable_name = 'tikv_gc_safe_point';

只要一个数据库是在 tikv_gc_safe_point 时间之后被 DROP，即可以用 FLASHBACK DATABASE 语法来恢复。

语法

FLASHBACK DATABASE DBName [TO newDBName]

FlashbackDatabaseStmt ::=
    'FLASHBACK' DatabaseSym DBName FlashbackToNewName

FlashbackToNewName ::=
    ( 'TO' Identifier )?

如果数据库被删除的时间超过了 GC life time (tikv_gc_safe_point)，就无法使用 FLASHBACK DATABASE 语句来恢复被删除的数据了，否则会返回错误。错误类似于 ERROR 1105 (HY000): Can't find dropped database 'test' in GC safe point 2022-11-06 16:10:10 +0800 CST。
不能用 FLASHBACK DATABASE 多次恢复同一个被删除的数据库，因为 FLASHBACK DATABASE 所恢复数据库的 schema ID 和原被删除数据库的 schema ID 一致，多次恢复同一数据库会导致重复的 schema ID。在 TiDB 中，所有数据库的 schema ID 必须全局唯一。
在开启 TiDB Binlog 时，使用 FLASHBACK DATABASE 需要注意以下情况：
- 下游从集群也需要支持 FLASHBACK DATABASE。
- 从集群的 GC life time 一定要长于主集群的 GC life time。否则上下游同步存在的延迟可能也会造成下游恢复数据失败。
- 如果 TiDB Binlog 同步出错，则需要在 TiDB Binlog 中过滤掉该数据库，同时手动全量重新导入该数据库的数据。

恢复被 DROP 删除的 test 数据库：

DROP DATABASE test;

FLASHBACK DATABASE test;

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