人大金仓Kingbase数据库备份和还原
前言
最近在项目开发过程中，使用了国产数据库人大金仓（即Kingbase数据库），在使用过过程中需要对数据库进行备份与还原，在此对相关的命令进行简单介绍，以备不时之需。
Linux环境下安装人大金仓可参考此篇文章：Linux环境下安装人大金仓数据库
命令介绍
人大金仓中的备份命令为 sys_dump，数据还原的方式有两种，分别是ksql、sys_restore命令，下面对这几个命令分别进行介绍。
备份命令sys_dump
sys_dump 是用于备份 KingbaseES 数据库的工具。根据官网介绍，即使数据库目前正在并发使用，它也能创建一致的备份。sys_dump 不阻塞其他用户访问数据库（读取或写入）。
使用sys_dump时，需要进入到数据库安装路径下的Server/bin 目录下执行。人大金仓的默认安装路径为 /opt/Kingbase/ES/V8，如下所示：
执行sys_dump命令时需要进入到Server/bin目录下执行。
sys_dump 命令可以将数据备份为SQL脚本文件和dump归档文件。
- 如下示例备份为sql脚本文件：
./sys_dump -h 127.0.0.1 -p 54321 -d db_demo -U system -f /opt/backup/db_demo.sql
- 如下示例备份为dump归档文件：
./sys_dump -h 127.0.0.1 -p 54321 -d db_demo -U system -Fc -f /opt/backup/db_demo.dump
备份dump文件时 最好加上 -Fc 参数，否则在使用sys_restore命令进行还原时会出现如下提示：
# 输入文件显示为文本格式转储。请使用ksql
sys_restore: error: input file appears to be a text format dump. Please use ksql.
其它都一样，只是后缀名不同。
执行上诉命令后，需要输入相关用户对应的密码，如上需要输入system对应的密码。
以上命令是没有任何信息输出的，如果想查看输出的信息，可以使用标准输出将内容写入文件（前提是有输出），如下所示：
./sys_dump -h 127.0.0.1 -p 54321 -d db_demo -U system -f /opt/backup/db_demo.dump >> /opt/backup/backup.log
查看 log文件内容即可。
命令各参数介绍
- -h：Kingbase服务器IP地址；
- -p：Kingbase监听端口号；
- -d：指定要连接到的数据库名；
- -U：要使用哪个用户连接；（Kingbase可以创建多个用户，可以使用默认的system，也可以使用其他自建用户）。
- -Fc：-F即format，也即选择输出的格式，有多种值，其中两种如下，其他的不再介绍，可查看下方官网文档。
- p：plain，输出一个纯文本形式的 SQL 脚本文件（默认值）。
- c：custom，输出一个适合于作为 sys_restore 输入的自定义格式归档。
- -f：将输出写到指定目录下的某个文件，该参数配合自定义目录使用。
说明：其他命令的配置项基本相同，后续不再赘述！
上诉命令执行完成后，会在指定目录生成db.demo.sql文件，此时说明已经备份完成。
sys_dump 更多信息请查看官网介绍
还原命令
人大金仓中，sys_restore 命令和 ksql 命令都可以进行数据还原。只是有一些区别，下边详细说。
sys_restore命令
sys_restore 可以从由 sys_dump命令创建的dump归档文件还原数据库数据。该命令需要在安装路径下的Server/bin 目录下执行。
- 首先使用sys_dump命令备份dump文档文件
./sys_dump -h 127.0.0.1 -p 54321 -d db_demo -U system -Fc -f /opt/backup/db_demo.dump >> /opt/backup/backup.log
- 使用sys_restore 命令进行数据还原
还原时会打出信息到标准输出上，可以使用文件进行接收。
./sys_restore -h 127.0.0.1 -p 54321 -d db_demo -U system /opt/backup/db_demo.dump >> /opt/backuo/restore.log 2>&1
执行命令、输入密码后即可成功还原数据。
那么sys_restore 能否还原SQL文件呢，试一下便知！
./sys_restore -h 127.0.0.1 -p 54321 -d db_demo -U system /opt/backup/db_demo.sql >> /opt/backuo/restore.log 2>&1
经过测试，sys_restore 命令也可以还原sql脚本文件。
更多sys_restore命令详细内容请参考官方文档
ksql
Ksql 是 KingbaseES 数据库的主要命令行界面。可以使用 Ksql 设置数据库初始化参数、创建和管理用户、创建和更改数据库对象 (例如表和索引)、插入和更新数据、运行 SQL 查询等等。当然也可以使用 Ksql 连接到 KingbaseES 数据库实例。
- 使用ksql还原sql脚本文件
./ksql -h "127.0.0.1" -p 54321 -d db_demo -U ledger -f /opt/backup/db_demo.sql >> /opt/backup/ksql_restore.log 2>&1
- 使用ksql还原dump文件
./ksql -h "127.0.0.1" -p 54321 -d db_demo -U ledger -f /opt/backup/db_demo.dump >> /opt/backup/ksql_restore.log 2>&1
在使用ksql进行还原时请注意，如果你还原的文件是 通过sys_dump 命令 并且加了 -F（format --format=format） 参数的，那么就不能通过ksql进行还原，而是要通过sys_restore命令进行还原，否则会报如下信息：
# 输入是Kingbase自定义格式转储。
The input is a Kingbase custom-format dump.
# 使用sys_restore命令行客户端将此转储还原到数据库。
Use the sys_restore command-currLine client to restore this dump to a database.
通过 sys_dump 命令备份时不加 -F（format --format=format） 参数，不管是SQL脚本文件还是dump归档文件都是可以通过ksql进行还原恢复的，注意此区别。
简单记录，以备不时之需！
如有帮助，还请多多点赞、收藏。