Kingbase 数据库物理备份与恢复操作手册

版本环境：KingbaseES V8R6
适用对象：DBA / 运维工程师 / 技术支持人员
目标用途：生产环境灾备保障、全量迁移、异地容灾恢复

一、物理备份操作流程

物理备份是指直接对数据库实例的物理文件进行复制，具备完整性强、恢复速度快等特点，适合关键系统的数据保护。

1.1 创建备份目录

mkdir -p /home/kingbase/backup

建议为备份目录配置定期清理策略，避免磁盘空间被长期占用。

1.2 确认数据库运行状态

sys_ctl status -D $KINGBASE_DATA

期望输出示例：

sys_ctl: server is running (PID: 1298)
/data/KingbaseES/V8/.../kingbase -D /data/KingbaseES/data

✅ 建议备份前确认数据库处于正常运行状态，避免备份文件不完整。

1.3 执行物理备份命令

sys_basebackup -Ft -Xs -Pv -U system -p 54321 -c fast -D /home/kingbase/backup

参数说明：

参数	说明
-Ft	输出格式为 tar（推荐）
-Xs	同步备份 WAL 日志
-Pv	显示进度和详细信息
-U system	备份用户（需具备复制权限）
-p	数据库监听端口
-c fast	设置检查点模式为快速
-D	目标备份目录

1.4 核查备份结果

ls /home/kingbase/backup/

示例输出：

base.tar  sys_wal.tar  24626.tar

• base.tar：数据库主目录文件
• sys_wal.tar：WAL 日志归档目录
• 24626.tar：表空间文件，对应一个或多个自定义表空间

1.5 核查表空间链接

ll $KINGBASE_DATA/sys_tblspc

输出示例：

lrwxrwxrwx 1 kingbase kingbase 19 Jun 6 15:12 24626 -> /home/kingbase/ptbs

表空间 OID 与路径需记录备份关系，便于后续恢复时建立符号链接。

二、物理恢复操作流程

本节介绍如何基于完整备份文件进行物理恢复。适用于灾难恢复、测试环境搭建、新实例部署等场景。

注意事项：

• 恢复目标实例不需要初始化数据库（不执行 initdb）。
• 所有恢复操作建议在断网状态下进行，防止误连接生产环境。
• 恢复操作应在原版本或兼容版本 Kingbase 上执行。

2.1 解压备份文件

创建恢复目录并设置权限：

mkdir -p $KINGBASE_DATA
chmod 700 $KINGBASE_DATA

解压核心数据文件与 WAL 日志：

tar -xvf base.tar -C $KINGBASE_DATA
tar -xvf sys_wal.tar -C $KINGBASE_DATA/sys_wal

解压表空间文件：

mkdir -p /home/kingbase/ptbs
tar -xvf 24626.tar -C /home/kingbase/ptbs

表空间文件名 24626.tar 中的数字为表空间 OID，应与原环境保持一致。

重建表空间软链接：

cd $KINGBASE_DATA/sys_tblspc
ln -s /home/kingbase/ptbs 24626  # OID 请根据实际匹配

2.2 启动数据库并验证

systemctl start kingbase

如启动成功，可通过 ksql 工具登录验证：

ksql -U system -d <数据库名>

三、后续建议与运维规范

建议项	说明
配置自动备份计划	使用 crontab 定时执行 sys_basebackup 任务
备份一致性校验	建议结合 md5sum 或 sha256sum 校验备份文件完整性
保留备份版本不低于 3 个	防止单点备份损坏导致无法恢复
分离表空间与数据文件	提升恢复灵活性，适应多磁盘部署
配合逻辑备份双重保障	可使用 sys_dump 实现逻辑级精细恢复
周期性进行恢复演练	定期验证备份有效性，提升应急恢复能力

总结

通过使用 sys_basebackup 工具，KingbaseES 可实现全量、强一致性的数据物理备份。该方式不仅操作简洁高效，还能显著提升恢复可靠性。配合标准化恢复流程与表空间管理策略，可有效应对数据灾难、迁移、异地部署等复杂场景。