Skip to content

Latest commit

 

History

History
64 lines (42 loc) · 2.03 KB

sql-statement-flashback-database.md

File metadata and controls

64 lines (42 loc) · 2.03 KB
Raw
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 必须全局唯一。

示例

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

    DROP DATABASE test;
    FLASHBACK DATABASE test;

  • 恢复被 DROP 删除的 test 数据库并重命名为 test1：

    DROP DATABASE test;
    FLASHBACK DATABASE test TO test1;

MySQL 兼容性

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