sql: add doc for flashback database (#11915)

TOC.md

@@ -656,6 +656,7 @@
       - [`EXPLAIN ANALYZE`](/sql-statements/sql-statement-explain-analyze.md)
       - [`EXPLAIN`](/sql-statements/sql-statement-explain.md)
       - [`FLASHBACK CLUSTER TO TIMESTAMP`](/sql-statements/sql-statement-flashback-to-timestamp.md)
+      - [`FLASHBACK DATABASE`](/sql-statements/sql-statement-flashback-database.md)
       - [`FLASHBACK TABLE`](/sql-statements/sql-statement-flashback-table.md)
       - [`FLUSH PRIVILEGES`](/sql-statements/sql-statement-flush-privileges.md)
       - [`FLUSH STATUS`](/sql-statements/sql-statement-flush-status.md)

sql-statements/sql-statement-flashback-database.md

@@ -0,0 +1,70 @@
+---
+title: FLASHBACK DATABASE
+summary: TiDB 数据库中 FLASHBACK DATABASE 的使用概况。
+---
+
+# FLASHBACK DATABASE
+
+TiDB v6.4.0 引入了 `FLASHBACK DATABASE` 语法，其功能是在 Garbage Collection (GC) life time 时间内，可以用 `FLASHBACK DATABASE` 语句来恢复被 `DROP` 删除的数据库以及数据。
+
+可以使用系统变量 [`tidb_gc_life_time`](/system-variables.md#tidb_gc_life_time-从-v50-版本开始引入) 配置数据的历史版本的保留时间（默认值是 `10m0s`）。可以使用以下 SQL 语句查询当前的 `safePoint`，即 GC 已经清理到的时间点：
+
+```sql
+SELECT * FROM mysql.tidb WHERE variable_name = 'tikv_gc_safe_point';
+```
+
+只要一个数据库是在 `tikv_gc_safe_point` 时间之后被 `DROP`，即可以用 `FLASHBACK DATABASE` 语法来恢复。
+
+## 语法
+
+```sql
+FLASHBACK DATABASE DBName [TO newDBName]
+```
+
+### 语法图
+
+```ebnf+diagram
+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` 数据库：
+
+    ```sql
+    DROP DATABASE test;
+    ```
+
+    ```sql
+    FLASHBACK DATABASE test;
+    ```
+
+- 恢复被 `DROP` 删除的 `test` 数据库并重命名为 `test1`：
+
+    ```sql
+    DROP DATABASE test;
+    ```
+
+    ```sql
+    FLASHBACK DATABASE test TO test1;
+    ```
+
+## MySQL 兼容性
+
+该语句是 TiDB 对 MySQL 语法的扩展。