闪回恢复

查询过去某个时间点表的快照数据，用于查看和逻辑重建被意外删除或更改的受损数据。基于MVCC多版本机制，通过检索旧版本获取指定历史版本数据。

需要设置GUC参数undo_retention_time，该参数的值表示旧版本undo的保留时间。

--前置操作建表和插入数据。
gaussdb=# CREATE TABLE tb_t1 (c1 int, c2 int) WITH(storage_type = ustore);
gaussdb=# INSERT INTO tb_t1 values (1,1),(2,2);

--查询当前时间和CSN。
gaussdb=# SELECT now(), int8in(xidout(next_csn)) FROM gs_get_next_xid_csn() limit 1;
              now              | int8in  
-------------------------------+---------
 2025-04-22 15:22:47.574995+08 | 2020912
(1 row)

--模拟数据误操作。
gaussdb=# UPDATE tb_t1 SET C1=222,C2=222 WHERE C1 = 2;
gaussdb=# SELECT * FROM tb_t1;
 c1  | c2  
-----+-----
   1 |   1
 222 | 222
(2 rows)

--根据时间查询该表修改之前的数据。
gaussdb=# SELECT * FROM tb_t1 TIMECAPSULE TIMESTAMP '2025-04-22 15:22:47.574995';
 c1 | c2 
----+----
  1 |  1
  2 |  2
(2 rows)

--根据CSN查询该表修改之前的数据。
gaussdb=# SELECT * FROM tb_t1 TIMECAPSULE CSN '2020912';
 c1 | c2 
----+----
  1 |  1
  2 |  2
(2 rows)

--删除。
gaussdb=# DROP TABLE tb_t1;

闪回表可以将表恢复至特定时间点或CSN点。当逻辑损坏仅限于一个或一组表、而非整个数据库时，可借助该特性（基于MVCC多版本机制）快速实现表级数据还原。

需要设置GUC参数undo_retention_time，该参数的值表示旧版本undo的保留时间。

--前置操作建表和插入数据。
gaussdb=# CREATE TABLE tb_t2 (c1 int, c2 int) WITH(storage_type = ustore);
gaussdb=# INSERT INTO tb_t2 VALUES (1,1),(2,2);

--查询当前时间和CSN。
gaussdb=# SELECT now(), int8in(xidout(next_csn)) FROM gs_get_next_xid_csn() limit 1;
             now              | int8in  
------------------------------+---------
 2025-04-22 15:32:22.99132+08 | 2021175
(1 row)


--模拟数据误操作。
gaussdb=# UPDATE tb_t2 SET c1 = 222, c2 = 222 WHERE C1 = 2;
gaussdb=# SELECT * FROM tb_t2;
 c1  | c2  
-----+-----
   1 |   1
 222 | 222
(2 rows)

--将表闪回至误操作之前时间点。
gaussdb=# TIMECAPSULE table tb_t2 TO TIMESTAMP to_timestamp('2025-04-22 15:32:22.99132','YYYY-MM-DD HH24:MI:SS.FF');
gaussdb=# SELECT * FROM tb_t2;
 c1 | c2 
----+----
  1 |  1
  2 |  2
(2 rows)

--也可以使用如下SQL,根据CSN闪回该表。
gaussdb=# UPDATE tb_t2 SET c1 = 333, c2 = 333 where c1 = 2;
gaussdb=# TIMECAPSULE table tb_t2 TO CSN 2021175;
gaussdb=# SELECT * FROM tb_t2;
 c1 | c2 
----+----
  1 |  1
  2 |  2
(2 rows)

--删除。
gaussdb=# DROP TABLE tb_t2;

• 闪回DROP：可以恢复意外删除的表，从回收站中恢复被删除的表及其附属结构，如索引、表约束等。闪回DROP是基于回收站机制，通过还原回收站中记录的表的物理文件，实现已DROP表的恢复。
• 闪回TRUNCATE：可以恢复误操作或意外被TRUNCATE的表，从回收站中恢复被TRUNCATE的表及索引的物理数据。闪回TRUNCATE基于回收站机制，通过还原回收站中记录的表的物理文件，实现已TRUNCATE表的恢复。

• 设置GUC参数enable_recyclebin的值为on，启用回收站功能。
• 设置GUC参数recyclebin_retention_time，该参数的值为回收站保留对象的时间，超时的对象回收站会自动清理。

--前置操作建表和插入数据。
gaussdb=# CREATE TABLE tb_t3 (c1 int,c2 int) WITH(storage_type = ustore);
gaussdb=# INSERT INTO tb_t3 VALUES (1,1), (2,2);

--删除该表。
gaussdb=# DROP TABLE tb_t3;

--闪回至删除之前。
gaussdb=# TIMECAPSULE TABLE tb_t3 TO BEFORE DROP;
gaussdb=# SELECT * FROM tb_t3;
 c1 | c2 
----+----
  1 |  1
  2 |  2
(2 rows)

--使用TRUNCATE清空该表。
gaussdb=# TRUNCATE TABLE tb_t3;

--闪回至清空之前。
gaussdb=# TIMECAPSULE TABLE tb_t3 TO BEFORE TRUNCATE;
gaussdb=# SELECT * FROM tb_t3;
 c1 | c2 
----+----
  1 |  1
  2 |  2
(2 rows)

--删除。
DROP TABLE tb_t3;

恢复意外删除的库，从库级回收站中恢复被删除的库及其关联对象。闪回库基于回收站机制，通过还原回收站中记录的库的物理文件，实现已DROP库的恢复。

• 开启enable_db_recyclebin参数，启用回收站。
• dbrecyclebin_retention_time参数用于设置回收站对象的保留时间，超过该时间的回收站对象将被自动清理。
• dbrecyclebin_maxsize参数用于设置回收站容量，超过容量将不能放入回收站。