更新时间:2026-10-21 GMT+08:00
分享

TIMECAPSULE DATABASE

功能描述

在人为操作或应用程序错误时,使用TIMECAPSULE DATABASE语句可将库回收站中的数据库对象恢复。

注意事项

  • TIMECAPSULE DATABASE语句的用法支持库级回收站对象从回收站中闪回,不支持M兼容库下创建的Schema库对象闪回。
  • 不适用闪回DROP功能的场景:
    • 回收站关闭场景:enable_db_recyclebin = off。
    • 系统处于维护态(xc_maintenance_mode = on)或从不支持的基线版本升级到支持的版本的升级场景。
    • 回收站对象被清理后无法闪回DROP,dbrecyclebin_retention_time参数用于设置回收站对象保留时间。
    • 回收站中的数据库,不支持连接、DQL、DML、DDL、DCL操作。
  • 数据库DROP闪回约束:
    可以指定原始用户指定的数据库名称,或对象删除时系统分配的生成名称。
    • 回收站中的数据库,在没有恢复前需要占用额外的存储空间。
    • 支持包含Astore、Ustore数据表的数据库场景,不支持Dstore场景。
    • 对齐DROP DATABASE的报错场景。
    • 不支持PDB闪回。
    • 数据库所在表空间的磁盘达到容量阈值,被设置为磁盘只读后,无法进行闪回。
    • 回收站中系统生成的对象名称是唯一的。因此,如果指定系统生成名称,那么数据库将在回收站检索指定的对象。使用“SELECT * FROM gs_db_recyclebin;”语句查看回收站中的内容。
    • 如果指定了用户指定的名称,且回收站中包含多个该名称的对象,那么数据库检索回收站中最近移动的对象。如果需要检索更早版本的表,请按以下步骤执行:
      • 指定需要检索的库的系统生成名称。

      • 执行TIMECAPSULE DATABASE ... TO BEFORE DROP语句,直到找到要检索的表。

    • dbrecyclebin_retention_time配置参数用于设置回收站对象保留时间,超过该时间的回收站对象将被自动清理。
    • 若表空间的DML操作导致表空间容量不足,会自动清理库回收站中此表空间关联的数据库对象。
    • 用户需持有管理员权限或者目标库的创建权限。
    • TIMECAPSULE DATABASE支持在事务块内运行。

语法格式

TIMECAPSULE DATABASE database_name TO BEFORE DROP [RENAME TO new_name];

参数说明

  • database_name

    指定需要闪回的数据库名称。

  • TO BEFORE DROP

    使用这个子句检索回收站中已删除的数据库。

  • RENAME TO

    为从回收站中检索的数据库指定一个新名称。

示例

  • 从库回收站中闪回数据库

    前提条件:

    示例一:闪回数据库不重命名。

    --建库。
    gaussdb=# create database flashback_test;
    CREATE DATABASE
    --删除库。
    gaussdb=# drop database flashback_test;
    DROP DATABASE
    --查看回收站。
    gaussdb=# select * from gs_db_recyclebin;
     rcydbid |          rcyname          | rcyoriginname  | rcyrecyclecsn |        rcyrecycletime         | rcytablespaces | rcydbsize 
    ---------+---------------------------+----------------+---------------+-------------------------------+----------------+-----------
       82513 | BIN$1425167F$2F524358==$0 | flashback_test |         13888 | 2024-12-11 08:55:18.631069-05 | 1663           |     26272
    (1 row)
    --通过回收站对象名闪回已删除的库。
    gaussdb=# timecapsule database "BIN$1425167F$2F524358==$0" to before drop;
    TimeCapsule Database
    --或通过原名闪回已删除的库。
    gaussdb=# timecapsule database flashback_test to before drop;
    TimeCapsule Database
    gaussdb=# select * from gs_db_recyclebin;
     rcydbid | rcyname | rcyoriginname | rcyrecyclecsn | rcyrecycletime | rcytablespaces | rcydbsize 
    ---------+---------+---------------+---------------+----------------+----------------+-----------
    (0 rows)
    --连接库。
    gaussdb=# \c flashback_test
    Non-SSL connection (SSL connection is recommended when requiring high-security)
    You are now connected to database "flashback_test" as user "omm".
    flashback_test=# 

    示例二:闪回数据库并重命名。

    --建库。
    gaussdb=# create database flashback_test;
    CREATE DATABASE
    --删除库。
    gaussdb=# drop database flashback_test;
    DROP DATABASE
    --查看回收站。
    gaussdb=# select * from gs_db_recyclebin;
     rcydbid |          rcyname          | rcyoriginname  | rcyrecyclecsn |        rcyrecycletime         | rcytablespaces | rcydbsize 
    ---------+---------------------------+----------------+---------------+-------------------------------+----------------+-----------
       82513 | BIN$1425167F$2F524358==$0 | flashback_test |         13888 | 2024-12-11 08:55:18.631069-05 | 1663           |     26272
    (1 row)
    --通过回收站对象名闪回已删除的库并重命名。
    gaussdb=# timecapsule database "BIN$1425167F$2F524358==$0" to before drop rename to flashback_test2;
    TimeCapsule Database
    --或者通过原名闪回已删除的库并重命名。
    gaussdb=# timecapsule database flashback_test to before drop rename to flashback_test2;
    TimeCapsule Database
    gaussdb=# select * from gs_db_recyclebin;
     rcydbid | rcyname | rcyoriginname | rcyrecyclecsn | rcyrecycletime | rcytablespaces | rcydbsize 
    ---------+---------+---------------+---------------+----------------+----------------+-----------
    (0 rows)
    --连接库。
    gaussdb=# \c flashback_test2
    Non-SSL connection (SSL connection is recommended when requiring high-security)
    You are now connected to database "flashback_test2" as user "omm".
    flashback_test2=# 

相关文档