TaurusDB库表回收站

• 2.0.57.240900≤内核版本<2.0.63.250300

  命名规则：__<storage_engine_name>_<db _name>_<table _name>_<id>

  约束限制：如果<db _name>或<table _name>长度超过10个字符，将截取前10个字符拼接到回收站表的表名中，并在<id>后增加“_”字符表示原库名或原表名被截断。

  表1 参数解释

  参数	解释
  storage_engine_name	当前仅支持innodb。
  db_name	数据库名称。
  table_name	表名称。
  id	回收站系统自动生成的唯一ID，保证相同表名的表被移入回收站后表名不会出现重复。

• 内核版本 ≥ 2.0.63.250300

  命名规则：__<storage_engine_name>_<db_name>_<table_name>_<id>

  约束限制：

  • 1秒内仅允许在回收站中保存同库名同表名的1个版本，1秒内多次回收同库名同表名的表，后续操作将等待1秒后执行。
  • 回收站中生成的表名需满足MySQL命名规则，如原库名表名长度过长，生成的表名超过MySQL表名最长长度，则对该表执行DROP TABLE、DROP DATABASE、TRUNCATE TABLE语句会直接删除表，而不会移入回收站。
  • 如果DROP TABLE、DROP DATABASE、TRUNCATE TABLE语句操作的表库名或表名中包含@符号，则执行后不会进入回收站，会直接删除。

  表2 参数解释

  参数	解释
  storage_engine_name	当前仅支持innodb。
  db_name	数据库名称。
  table_name	表名称。
  id	回收站系统自动生成的唯一ID，保证相同表名的表被移入回收站后表名不会出现重复。

创建或者升级到大于等于2.0.57.240900的实例时，TaurusDB会初始化一个名为“__recyclebin__”的数据库。开启库表回收站后，执行DROP TABLE、DROP DATABASE、TRUNCATE TABLE语句不会直接删除表或数据库，而是暂时将指定表或数据库移入“__recyclebin__”库中，并将表或数据库重命名。

表被移入回收站后，表的触发器和外键将被彻底删除，无法恢复。

• 系统自动清理：开启后台自动清理功能后，实例主节点将创建后台清理线程，自动清理达到最大保存时间（rds_recycle_bin_retention）的表，默认保存3天。系统自动清理的表将被彻底删除，无法恢复。

  后台自动清理任务在RegionLessDB集群的从实例中不会执行自动清理。

• 手动清理：执行purge命令，手动清理回收站中的表。执行清理命令后，表将被彻底删除，无法恢复。

call dbms_recyclebin.show_tables();

| SCHEMA         | TABLE               | ORIGIN_SCHEMA | ORIGIN_TABLE | RECYCLED_TIME       | PURGE_TIME          |
| __recyclebin__ | test_db@t1@67ad67cb | test_db       | t1           | 2025-02-13 11:32:27 | 2025-02-16 11:32:27 |
| __recyclebin__ | test_db@t2@67ad67cb | test_db       | t2           | 2025-02-13 11:32:27 | 2025-02-16 11:32:27 |

手动创建与原表表结构相同的新表后，通过INSERT INTO ... SELECT ...语句将表中数据恢复到新表。

通过INSERT INTO ... SELECT ...语句进行恢复不会移除回收站中暂存的数据，支持多次恢复，且生成的Binlog兼容性最佳。如实例存在基于Binlog的复制链路（如DRS数据复制服务、灾备实例），请避免使用call dbms_recyclebin.restore_table命令对回收站中的表进行恢复，建议使用INSERT INTO ... SELECT ...对数据进行恢复，降低复制中断的风险。

示例：

call dbms_recyclebin.show_tables();
+----------------+---------------------+---------------+--------------+---------------------+---------------------+
| SCHEMA         | TABLE               | ORIGIN_SCHEMA | ORIGIN_TABLE | RECYCLED_TIME       | PURGE_TIME          |
+----------------+---------------------+---------------+--------------+---------------------+---------------------+
| __recyclebin__ | test_db@t1@67ad67cb | test_db       | t1           | 2025-02-13 11:32:27 | 2025-02-16 11:32:27 |
| __recyclebin__ | test_db@t2@67ad67cb | test_db       | t2           | 2025-02-13 11:32:27 | 2025-02-16 11:32:27 |
+----------------+---------------------+---------------+--------------+---------------------+---------------------+

INSERT INTO `test_db`.`t1` SELECT * FROM `__recyclebin__`.`test_db@t1@67ad67cb`;

call dbms_recyclebin.restore_table('TABLE_NAME');

参数说明：

TABLE_NAME：回收站中表的当前表名。

示例：

将回收站中表test_db@t1@67ad67cb恢复到原库test_db，并保留原表名t1。

call dbms_recyclebin.restore_table('test_db@t1@67ad67cb');

call dbms_recyclebin.restore_table('TABLE_NAME', 'DEST_DB', 'DEST_TABLE');

参数说明：

• TABLE_NAME：回收站中表的当前表名。
• DEST_DB：指定表恢复到的数据库。
• DEST_TABLE：指定表恢复后的表名。

约束限制：

• 执行恢复操作前请确保目标库存在，否则恢复命令将执行失败。
• 执行恢复操作前请确认目标库下不存在同名表，否则恢复将执行失败。
• 表回收站相关命令指定的引号内的库名、表名前后不允许有多余空格。

示例：

将回收站中表test_db@t1@67ad67cb恢复到指定库test_db2，并指定恢复后的表名为t3。

call dbms_recyclebin.restore_table('test_db@t1@67ad67cb','test_db2','t3');

• 恢复回收站中所有指定原库的表到原库。

  call dbms_recyclebin.restore_db('DB_NAME');

  参数说明：

  DB_NAME：回收站中表的原库名。

  示例：

  将回收站中原库为test_db的表全部恢复到原库test_db，并保留原表名。

  call dbms_recyclebin.restore_db ('test_db');

• 恢复回收站中所有指定原库的表到新数据库。

  call dbms_recyclebin.restore_db ('DB_NAME', 'DEST_DB');

  参数说明：

  • DB_NAME：回收站中表的原库名。
  • DEST_DB：指定表恢复到的数据库。

  示例：

  将回收站中原库为test_db的表全部恢复到新库test_db2，并保留原表名。

  call dbms_recyclebin.restore_db('test_db', 'test_db2');

call dbms_recyclebin.purge_table('TABLE_NAME');

参数说明：

TABLE_NAME：回收站中表的当前表名。

示例：

手动清理回收站中表test_db@t1@67ad67cb。

call dbms_recyclebin.purge_table('test_db@t1@67ad67cb');