KingBase 备份操作手册

KingBase 备份操作手册

目录

• 1. 环境信息
• 2. 备份架构概述
• 3. Kubernetes 层面操作
• 4. 数据库层面命令
• 5. 当前备份策略
• 6. 备份文件位置
• 7. 常用管理命令
• 8. 故障排查

1. 环境信息

2. 备份架构概述

┌─────────────────────────────────────────────────────────────────┐ │ Kubernetes 集群 │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ qfusion-admin Namespace │ │ │ │ │ │ │ │ ┌─────────────────────┐ ┌─────────────────────────┐ │ │ │ │ │ Backup CR │ │ KingBase Pods │ │ │ │ │ │ kingbase-ffd105d6 │───▶│ replica0-0 (Primary) │ │ │ │ │ │ -backup │ │ replica1-0 (Standby) │ │ │ │ │ └─────────────────────┘ └─────────────────────────┘ │ │ │ │ │ │ │ │ │ ▼ │ │ │ │ ┌─────────────────┐ │ │ │ │ │ sys_rman │ │ │ │ │ │ (pgBackRest) │ │ │ │ │ └─────────────────┘ │ │ │ └────────────────────────────────────────────────────────────┘ │ │ │ │ ┌────────────────────────────────────────────────────────────┐ │ │ │ Storage: S3 (S3地址@备份桶:9090) │ │ │ └────────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘

备份工具说明

• 工具名称: sys_rman (KingBase 版 pgBackRest)
• 版本: 2.27
• 二进制路径:/install/kingbase/bin/sys_rman
• 配置文件:/mnt/configs/sys_rman.conf
• 日志路径:/opt/Kingbase/ES/V8/kingbase/log/kingbase-backup.log

3. Kubernetes 层面操作

3.1 环境准备

# 设置集群配置exportKUBECONFIG=/bpx/.xx-admin.conf# 或使用别名source/bpx/.bpx

3.2 创建备份任务

全量备份

kubectl annotate backup kingbase-ffd105d6-backup job/full=manual -n qfusion-admin

增量备份

kubectl annotate backup kingbase-ffd105d6-backup job/inc=manual -n qfusion-admin

日志备份/归档

kubectl annotate backup kingbase-ffd105d6-backup job/log=manual -n qfusion-admin

清理备份

kubectl annotate backup kingbase-ffd105d6-backup job/clean=manual -n qfusion-admin

3.3 取消备份任务

取消所有备份任务

kubectl annotate backup kingbase-ffd105d6-backup job/cancel=ALL -n qfusion-admin

取消指定备份任务

kubectl annotate backup kingbase-ffd105d6-backup job/cancel=<backup_id>-n qfusion-admin

3.4 查看备份状态

# 查看备份资源状态kubectl get backup kingbase-ffd105d6-backup -n qfusion-admin# 查看备份任务历史kubectl get job -n qfusion-admin|grepkingbase-ffd105d6# 查看备份 Pod 状态kubectl get pods -n qfusion-admin|grepkingbase.*backup# 查看 backup 详细信息kubectl describe backup kingbase-ffd105d6-backup -n qfusion-admin

4. 数据库层面命令

4.1 进入数据库 Pod

kubectlexec-it kingbase-ffd105d6-replica0-0 -n qfusion-admin -- /bin/bash

4.2 全量备份

/install/kingbase/bin/sys_rman backup\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase\--type=full\--compress-level=6\--process-max=2\--start-fast

参数说明：

4.3 增量备份

/install/kingbase/bin/sys_rman backup\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase\--type=incr\--compress-level=6\--process-max=2\--start-fast

4.4 差异备份

/install/kingbase/bin/sys_rman backup\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase\--type=diff\--compress-level=6\--process-max=2\--start-fast

4.5 WAL 日志归档

/install/kingbase/bin/sys_rman archive-push\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase

4.6 备份清理（过期备份）

/install/kingbase/bin/sys_rman expire\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase

5. 当前备份策略

5.1 定时任务配置

5.2 配置文件内容

[kingbase] kb1-path=/opt/Kingbase/ES/V8/kingbase/data kb1-port=54321 kb1-user=esrep kb2-path=/opt/Kingbase/ES/V8/kingbase/data kb2-port=54321 kb2-user=esrep kb2-host=245.0.0.217 kb2-host-user=kingbase [global] repo1-path=/backrestrepo/kingbase-ffd105d6-backups repo1-retention-full=2 log-path=/opt/Kingbase/ES/V8/kingbase/log log-level-file=info log-level-console=info log-subprocess=y process-max=2 compress-type=gz compress-level=6 start-fast=y link-all=y band-width=0 non-archived-space=1024 archive-timeout=1800

6. 备份文件位置

6.1 本地备份目录

/backrestrepo/kingbase-ffd105d6-backups/ ├── backup/ │ └── kingbase/ │ ├── 20260203-144518F/ # 全备备份集 │ ├── 20260203-160642F/ # 全备备份集 │ └── backup.info # 备份元信息 └── archive/ └── kingbase/ └── 12-1/ └── 0000000100000000/ # WAL 归档文件

6.2 容器内挂载目录

/opt/mnt/kingbase-ffd105d6-backups/# 备份存储目录

6.3 备份信息文件

# 查看备份信息cat/opt/mnt/kingbase-ffd105d6-backups/backup/kingbase/backup.info

7. 常用管理命令

7.1 查看备份信息

# 查看所有备份集信息/install/kingbase/bin/sys_rman info\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase# 查看备份列表/install/kingbase/bin/sys_rman repo-ls\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase\--repo=1

7.2 检查备份配置

/install/kingbase/bin/sys_rman check\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase

7.3 查看备份日志

# 查看最新备份日志tail-f /opt/Kingbase/ES/V8/kingbase/log/kingbase-backup.log# 查看备份历史cat/opt/Kingbase/ES/V8/kingbase/log/kingbase-backup.log|grep"backup command begin"

7.4 备份集操作

# 查看备份集详情/install/kingbase/bin/sys_rman info\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase\--set=20260203-144518F# 合并备份集/install/kingbase/bin/sys_rman merge\--config=/mnt/configs/sys_rman.conf\--stanza=kingbase

8. 故障排查

8.1 备份状态检查

# Kubernetes 层面检查kubectl get backup kingbase-ffd105d6-backup -n qfusion-admin -o yaml# 查看 running 和 queueing 任务kubectl get backup kingbase-ffd105d6-backup -n qfusion-admin\-ojsonpath='{.status.conditions[?(@.type=="RUNNING_JOBS")].status}'kubectl get backup kingbase-ffd105d6-backup -n qfusion-admin\-ojsonpath='{.status.conditions[?(@.type=="QUEUEING_JOBS")].status}'

8.2 日志查看

# 查看 backup-set-controller 日志kubectl logs -n qfusion -lapp=backup-set-worker --tail=100# 查看数据库备份日志kubectlexec-it kingbase-ffd105d6-replica0-0 -n qfusion-admin --\tail-100 /opt/Kingbase/ES/V8/kingbase/log/kingbase-backup.log

8.3 常见问题

附录

A. sys_rman 命令参考

B. 备份类型对比

C. 快速命令参考

# 快速全备kubectl annotate backup kingbase-ffd105d6-backup job/full=manual -n qfusion-admin# 快速增备kubectl annotate backup kingbase-ffd105d6-backup job/inc=manual -n qfusion-admin# 快速归档kubectl annotate backup kingbase-ffd105d6-backup job/log=manual -n qfusion-admin# 快速清理kubectl annotate backup kingbase-ffd105d6-backup job/clean=manual -n qfusion-admin# 取消所有任务kubectl annotate backup kingbase-ffd105d6-backup job/cancel=ALL -n qfusion-admin

文档版本: 1.0
更新日期: 2026-02-03
维护者: QFusion Team