磐维数据库（PanWeiDB）V2.0-S3.1.0_B01 备份恢复文档

一、概述

磐维数据库 是一款基于开源 openGauss 内核开发的企业级关系型数据库。为了确保数据的安全性和业务的连续性，提供了多种备份恢复方案。本文档将详细介绍如何使用这些工具进行数据库的备份和恢复操作。

二、备份工具

磐维数据库提供了一下几种备份恢复工具：
1.gs_tar
功能描述：用于解压 pw_basebackup 命令生成的归档 tar 文件。
语法格式：gs_tar [OPTION]…
参数说明：-D, --destination=DIRECTORY：指定解压文件的输出目录。
-F, --filename=FILENAME：指定解压文件。

2.pw_basebackup
功能描述：基础的物理备份工具，可以将整个实例的数据进行备份。
语法格式：pw_basebackup [OPTION]…
参数说明：-D, --pgdata=DIRECTORY：备份文件输出的目录。
-F, --format=p|t：设置输出格式为 plain 或 tar。
-x，–xlog：在备份中包含所需的 WAL 文件。
-X，–xlog-method=fetch|stream：设置 xlog 传输方式。

3.pw_dump
功能描述：用于导出数据库相关信息的一种逻辑备份工具。
语法格式：pw_dump [OPTION]…
参数说明：-a, --data-only：只输出数据，不输出模式（数据定义）。
-c, --clean：在将创建数据库对象的指令输出到备份文件之前，先将清理（删除）数据库对象的指令输出到备份文件中。
-F, --format=c|d|t：选择输出格式。

4.pw_dumpall
功能描述：用于导出所有数据库相关信息的工具。
语法格式：pw_dumpall [OPTION]…
参数说明：-a, --data-only：只转储数据，不转储模式（数据定义）。
-c, --clean：在重新创建数据库之前，执行 SQL 语句清理（删除）这些数据库（对象）。
-g, --globals-only：只转储全局对象（角色和表空间），无数据库。

5.pw_probackup
功能描述：用于管理 PanWeiDB 数据库物理备份和恢复的工具。
语法格式：pw_probackup [OPTION]…
参数说明：-B backup-path：备份的路径。
-D pgdata-path：数据目录的路径。
-i backup-id：备份的唯一标识。
-j threads_num：设置备份、还原、合并进程的并行线程数。

三、恢复工具

1.pw_restore功能描述：导入由 pw_dump 生成的备份文件。
语法格式：pw_restore [OPTION]… FILE
参数说明：-d, --dbname=NAME：连接数据库 dbname 并直接导入到该数据库中。
-f, --file=FILENAME：指定生成脚本的输出文件，或使用-l 时列表的输出文件。
-C：导入数据库之前会先使用 CREATE DATABASE 创建数据库。
-e, --exit-on-error：当发送 SQL 语句到数据库时如果出现错误，请退出。

四、备份恢复流程

1.全量备份
使用 pw_basebackup 或 pw_dumpall 进行全量备份。
将备份文件存储在安全的位置。

2.增量备份
使用 pw_basebackup 或 pw_dump 进行增量备份。
将增量备份文件与全量备份文件一起存储。

3.恢复流程
停止数据库服务。
清空原数据库目录。
使用 pw_restore 导入备份文件。
启动数据库服务，检查数据完整性。

五、注意事项

1.在进行备份和恢复操作前，请确保数据库服务已停止。
2.备份文件应存储在安全、可靠的地方，避免数据丢失。
3.在恢复备份前，请确保目标数据库的版本与备份文件兼容。
4.在恢复过程中，如遇到错误，请及时联系技术支持。