openGauss基于PITR恢复测试

PITR恢复流程

1、将物理备份的文件替换目标数据库目录。
2、删除数据库目录下pg_xlog/中的所有文件。
3、将归档的WAL日志文件复制到pg_xlog文件中（此步骤可以省略，通过配置recovery.conf恢复命令文件中的restore_command
项替代）。
4、在数据库目录下创建恢复命令文件recovery.conf，指定数据库恢复的程度。
5、启动数据库。
6、连接数据库，查看是否恢复到希望预期的状态。
7、若已经恢复到预期状态，通过pg_xlog_replay_resume()指令使主节点对外提供服务。

recovery.conf文件配置

归档恢复配置

restore_command =
string：这个SHELL命令是获取WAL文件系列中已归档的WAL文件。字符串中的任何一个%f是用归档检索 中的文件名替换，
并且%p是用服务器上的复制目的地的路径名替换。 任意一个%r是用包含最新可用重启点的文件名替换。 restore_command = ‘cp
/mnt/server/archivedir/%f %p’

archive_cleanup_command = string：这个选项参数声明一个shell命令。在每次重启时会执行这个shell命令。
archivecleanup_command为清理备库不需要的归档WAL文件提供一个机制。 任何一个%r由包含最新可用重启点的文件名代替。
这是最早的文件， 因此必须保留_以允许恢复能够重新启动，因此所有早于%r的文件可以安全的移除。
archive_cleanup_command = ‘pg_archivecleanup /mnt/server/archivedir %r’

注意： 如果多个备服务器从相同的归档路径恢复时， 需要确保在任何一个备服务器在需要之前，不能删除WAL文件。

recovery_end_command = string 这个参数是可选的，用于声明一个只在恢复完成时执行的SHELL命令。
recovery_end_command是为以后的复制或恢复提供一个清理机制。

恢复目标设置

recovery.conf文件配置： 恢复目标设置 recovery_target_name =
string：此参数声明命名还原到一个使用pg_create_restore_point()创建的还原点。
recovery_target_name = ‘restore_point_1’

recovery_target_time = timestamp：此参数声明命名还原到一个指定时间戳。
recovery_target_time = ‘2025-01-01 12:00:00’

recovery_target_xid = string：这个参数声明还原到一个事务ID。 recovery_target_xid =
‘2500’

recovery_target_lsn = string：这个参数声明还原到日志的指定LSN点。 recovery_target_lsn =
‘0/0FFFFFF’

recovery_target_inclusive =
boolean：声明是否在指定恢复目标(true)之后停止，或在这(false)之前停止。改声明仅支持恢复目
标为recovery_target_time，recovery_target_xid和recovery_target_lsn的配置。
recovery_target_inclusive = true

说明:
recovery_target_name，recovery_target_time，recovery_target_xid，recovery_target_lsn这四个配置项仅同时支持一项。
如果不配置任何恢复目标，或配置目标不存在，则默认恢复到最新的WAL日志点。

模拟准备

检查是否开启归档日志

MogDB=# select name,setting from pg_settings where name like 'archive%' or name = 'wal_level'
MogDB-# ;
       name       |            setting             
------------------+--------------------------------
 archive_command  | cp %p /opt/mogdb/archivelog/%f
 archive_dest     | 
 archive_interval | 1
 archive_mode     | on
 archive_timeout  | 0
 wal_level        | hot_standby
(6 rows)

全备

mkdir -p /data/backup
gs_basebackup -D /data/backup  -p 26000

模拟测试数据

模拟recovery_target_name数据

MogDB=# create table test (id int,times timestamp,opt varchar(20));
select  pg_switch_xlog();
SELECT * FROM pg_control_checkpoint();
CREATE TABLE
MogDB=# insert into test values(1,now(),'first insert');
INSERT 0 1
MogDB=# 
MogDB=# select * from  pg_switch_xlog();
-[ RECORD 1 ]--+----------
pg_switch_xlog | 0/B002278

MogDB=# select pg_create_restore_point('restore_point_1');
-[ RECORD 1 ]-----------+----------
pg_create_restore_point | 0/C0001B8

模拟recovery_target_xid数据

MogDB=# insert into test values(2,now(),'second insert');
INSERT 0 1
MogDB=# select  pg_switch_xlog();
-[ RECORD 1 ]--+----------
pg_switch_xlog | 0/C0002C8
MogDB=# \x
Expanded display is on.
MogDB=# select * from pg_get_variable_info();
-[ RECORD 1 ]------------+-----------
node_name                | dn_6001
next_oid                 | 24579
next_xid                 | 15158
oldest_xid               | 12666
xid_vac_limit            | 4000012666
oldest_xid_db            | 16252
last_extend_csn_logpage  | 14
start_extend_csn_logpage | 0
next_commit_seqno        | 2023
latest_completed_xid     | 15157
startup_max_xid          | 15154

模拟recovery_target_lsn数据

MogDB=# insert into test values(3,now(),'third insert');
INSERT 0 1
MogDB=# select pg_switch_xlog();
 pg_switch_xlog 
----------------
 0/D000258
(1 row)
MogDB=# select * from pg_current_xlog_location();
 pg_current_xlog_location 
--------------------------
 0/E000148
(1 row)

模拟recovery_target_time数据

MogDB=# insert into test values(4,now(),'fourth  insert');
INSERT 0 1
MogDB=# select  pg_switch_xlog();
 pg_switch_xlog 
----------------
 0/E000258
(1 row)
MogDB=# select now();
              now              
-------------------------------
 2025-10-24 9:03:28.174921+08
(1 row)

模拟故障

**gs_om -t stop #停止数据库
rm -rf /opt/mogdb/data/* #删除数据目录**

恢复

cp -rf /data/backup/* /opt/mogdb/data/ #将基础全备拷贝到数据目录
vi recovery.conf

(1)还原点恢复
archive_cleanup_command = ‘pg_archivecleanup /opt/mogdb/archivelog %r’
recovery_target_xid = ‘15157’
recovery_target_inclusive = true

（2）XID恢复
archive_cleanup_command = ‘pg_archivecleanup /opt/mogdb/archivelog %r’
recovery_target_name = ‘restore_point_1’
recovery_target_inclusive = true

（3）恢复至lsn
archive_cleanup_command = ‘pg_archivecleanup /opt/mogdb/archivelog %r’
recovery_target_lsn = ‘0/D000258’
recovery_target_inclusive = true

（4）时间点还原
archive_cleanup_command = ‘pg_archivecleanup /opt/mogdb/archivelog %r’
recovery_target_time = ‘2025-04-18 16:03:30’
recovery_target_inclusive = true

编辑好不同的恢复需求
gs_om -t start

结束PITR

select pg_is_in_recovery();
如果查询结果是t则执行如下命令可恢复读写
select pg_xlog_replay_resume;