人大金仓数据库KingbaseES sys_basebackup

关键字：KingbaseES、人大金仓、sys_basebackup

1. 介绍

sys_basebackup是kingbase数据库的基础备份工具，用于数据库的全量备份，具体的使用过程可以通过—help查看。

1. 原理

基础备份大概分为三大步骤：

1. 主库做一次checkpoint，创建一个label文件；
2. 备库从主库拷贝数据文件；
3. 主库删除label文件，表示备份结束，备库可以使用备份的数据目录启动实例。

三、代码流程

main():sys_basebackup的主函数

GetConnection():建立数据库连接

GetWalSegmentSize():连接数据库以后，获取源主机的wal日志的段文件的大小

KCIStatementExecute():通过该函数在数据库连接中执行特定的SQL，返回一个包含该执行结果的kb_result结构体

PhysicalBackup():执行备份

BuildRecoveryConf():如果在命令中添加了-R参数，会在备份恢复中添加primary_conninfo的连接串（连接主机的信息）和其它恢复相关的配置信息。

ExecIdentityAuth():获取数据库的时间线和LSN

KCIStatementSend():发送一个BASE_BACKUP的SQL，提示主机做一次checkpoint，创建出label文件，为流复制做好准备

KCIResultGetColumnValue()；上面发送SQL之后主机会做一次checkpoint，然后获取WAL起始的位置

循环遍历表空间，累计出此次备份文件的总大小；

BeginLogStreamer():如果是流复制的方式，启动receiver后台进程接收主机发送的WAL日志

_beginthreadex()：创建子进程处理流复制

DealXLogMain():子进程的主要处理逻辑函数

AcceptAndFillTarFile()：接收数据文件，接收wal日志是上面的子进程，而其它数据文件的备份是由主进程来copy

KCICopyReceiveData():循环接收数据文件

传输结束，关闭资源，等待子进程退出，最后退出程序。

四、总结

sys_basebackup进程的备份过程涉及两种数据的拷贝：首先是wal日志的拷贝，有一个单独的进程来传输wal日志数据；其次额外的数据则是由sys_basebackup主进程来拷贝。