【openGauss】openGauss闪回恢复 - （史上最全）

---

闪回恢复

闪回恢复功能是数据库恢复技术的一环，可以有选择性的撤销一个已提交事务的影响，将数据从人为不正确的操作中进行恢复。在采用闪回技术之前，只能通过备份恢复、PITR等手段找回已提交的数据库修改，恢复时长需要数分钟甚至数小时。采用闪回技术后，恢复已提交的数据库修改前的数据，只需要秒级，而且恢复时间和数据库大小无关。

说明：
ASTORE引擎暂不支持闪回功能。
备机不支持闪回操作。

一、闪回查询

1.1、背景信息

• 闪回查询可以查询过去某个时间点表的某个snapshot数据，这一特性可用于查看和逻辑重建意外删除或更改的受损数据。闪回查询基于MVCC多版本机制，通过检索查询旧版本，获取指定老版本数据。

1.2、前提条件

• undo_retention_time参数用于设置undo旧版本的保留时间。

1.3、语法

{[ ONLY ] table_name [ * ] [ partition_clause ] [ [ AS ] alias [ ( column_alias [, ...] ) ] ]
[ TABLESAMPLE sampling_method ( argument [, ...] ) [ REPEATABLE ( seed ) ] ]
[TIMECAPSULE { TIMESTAMP | CSN } expression ]
|( select ) [ AS ] alias [ ( column_alias [, ...] ) ]
|with_query_name [ [ AS ] alias [ ( column_alias [, ...] ) ] ]
|function_name ( [ argument [, ...] ] ) [ AS ] alias [ ( column_alias [, ...] | column_definition [, ...] ) ]
|function_name ( [ argument [, ...] ] ) AS ( column_definition [, ...] )
|from_item [ NATURAL ] join_type from_item [ ON join_condition | USING ( join_column [, ...] ) ]}

语法树中“TIMECAPSULE {TIMESTAMP | CSN} expression”为闪回功能新增表达方式，其中TIMECAPSULE表示使用闪回功能，TIMESTAMP以及CSN表示闪回功能使用具体时间点信息或使用CSN（commit sequence number）信息。

1.4、参数说明

• TIMESTAMP

  • 指要查询某个表在TIMESTAMP这个时间点上的数据，TIMESTAMP指一个具体的历史时间。

• CSN

  • 指要查询整个数据库逻辑提交序下某个CSN点的数据，CSN指一个具体逻辑提交时间点，数据库中的CSN为写一致性点，每个CSN代表整个数据库的一个一致性点，查询某个CSN下的数据代表SQL查询数据库在该一致性点的相关数据。

备注：使用时间点进行闪回时，可能会有3s的误差。想要闪回到精确的操作点，需要使用CSN进行闪回。

1.5、使用示例

• 示例1：

SELECT * FROM t1 TIMECAPSULE TIMESTAMP to_timestamp ('2020-02-11 10:13:22.724718', 'YYYY-MM-DD HH24:MI:SS.FF');

• 示例2：

SELECT * FROM t1 TIMECAPSULE CSN 9617;

• 示例3：

SELECT * FROM t1 AS t TIMECAPSULE TIMESTAMP to_timestamp ('2020-02-11 10:13:22.724718', 'YYYY-MM-DD HH24:MI:SS.FF');

• 示例4：

SELECT * FROM t1 AS t TIMECAPSULE CSN 9617;

二、闪回表

2.1、背景信息

闪回表可以将表恢复至特定时间点，当逻辑损坏仅限于一个或一组表，而不是整个数据库时，此特性可以快速恢复表的数据。闪回表基于MVCC多版本机制，通过删除指定时间点和该时间点之后的增量数据，并找回指定时间点和当前时间点删除的数据，实现表级数据还原。

2.2、前提条件

• undo_retention_time参数用于设置undo旧版本的保留时间。

2.3、语法

TIMECAPSULE TABLE table_name TO { TIMESTAMP | CSN } expression

2.4、使用示例

TIMECAPSULE TABLE t1 TO TIMESTAMP to_timestamp ('2020-02-11 10:13:22.724718', 'YYYY-MM-DD HH24:MI:SS.FF');
TIMECAPSULE TABLE t1 TO CSN 9617;

三、闪回DROP/TRUNCATE

3.1、背景信息

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

3.2、前提条件

• 开启enable_recyclebin参数，启用回收站。
• recyclebin_retention_time参数用于设置回收站对象保留时间，超过该时间的回收站对象将被自动清理。

3.3、相关语法

3.3.1、删除表

DROP TABLE table_name [PURGE]

3.3.2、清理回收站对象

PURGE { TABLE { table_name }
| INDEX { index_name }
| RECYCLEBIN
}

3.3.3、闪回被删除的表

TIMECAPSULE TABLE { table_name } TO BEFORE DROP [RENAME TO new_tablename]

3.3.4、截断表

TRUNCATE TABLE { table_name } [ PURGE ]

3.3.5、闪回截断的表

TIMECAPSULE TABLE { table_name } TO BEFORE TRUNCATE

3.4、参数说明

3.4.1、DROP/TRUNCATE TABLE table_name PURGE

• 默认将表数据放入回收站中，PURGE直接清理。

3.4.2、PURGE RECYCLEBIN

• 表示清理回收站对象。

3.4.3、TO BEFORE DROP

使用这个子句检索回收站中已删除的表及其子对象。
可以指定原始用户指定的表的名称，或对象删除时数据库分配的系统生成名称。

• 回收站中系统生成的对象名称是唯一的。因此，如果指定系统生成名称，那么数据库检索指定的对象。使用“select * from gs_recyclebin;”语句查看回收站中的内容。

• 如果指定了用户指定的名称，且如果回收站中包含多个该名称的对象，然后数据库检索回收站中最近移动的对象。如果想要检索更早版本的表，你可以这样做：

  • 指定你想要检索的表的系统生成名称。

  • 执行TIMECAPSULE TABLE … TO BEFORE DROP语句，直到你要检索的表。

• 恢复DROP表时，只恢复基表名，其他子对象名均保持回收站对象名。用户可根据需要，执行DDL命令手工调整子对象名。

• 回收站对象不支持DML、DCL、DDL等写操作，不支持DQL查询操作（后续支持）。

• 闪回点和当前点之间，执行过修改表结构或影响物理结构的语句，闪回失败。执行过DDL的表进行闪回操作报错：“ERROR：The table definition of %s has been changed. ”。涉及namespace、表名改变等操作的DDL执行闪回操作报错： ERROR: recycle object %s desired does not exis；

• 如果基表有truncate trigger，truncate表时，无法触发trigger，不能同时truncate目标表。用户想要truncate目标表，需要手动操作。

3.4.4、RENAME TO

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

3.4.5、TO BEFORE TRUNCATE

闪回到TRUNCATE之前。

3.5、语法示例

DROP TABLE t1 PURGE;

PURGE TABLE t1;
PURGE TABLE "BIN$04LhcpndanfgMAAAAAANPw==$0";
PURGE INDEX i1;
PURGE INDEX "BIN$04LhcpndanfgMAAAAAANPw==$0";
PURGE RECYCLEBIN;

TIMECAPSULE TABLE t1 TO BEFORE DROP;
TIMECAPSULE TABLE t1 TO BEFORE DROP RENAME TO new_t1;
TIMECAPSULE TABLE "BIN$04LhcpndanfgMAAAAAANPw==$0" TO BEFORE DROP;
TIMECAPSULE TABLE "BIN$04LhcpndanfgMAAAAAANPw==$0" TO BEFORE DROP RENAME TO new_t1;