KingbaseES 工具sys_dump，sys_restore使用介绍
说明：
KingbaseES V8R6版本中自带数据库备份导出sys_dump，和备份恢复sys_restore工具。
sys_dump：把KingbaseES数据库抽取为一个脚本文件或其他归档文件。数据库正在被并发使用，它也能创建一致的备份。但在日常使用中，建议在业务工作停止时做数据导出工作（不需要关闭数据库），以免对业务性能产生影响。
sys_restore：从一个由sys_dump创建的归档文件恢复一个KingbaseES数据库。
本次案例数据库版本：
test=# select version();
version
----------------------------------------------------------------------------------------------------------------------
KingbaseES V008R006C005B0023 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 4.1.2 20080704 (Red Hat 4.1.2-46), 64-bit
(1 行记录)
sys_dump 命令格式：
sys_dump只转储单个数据库。要备份一个集簇或者集簇中对于所有数据库公共的全局对象（例如角色和表空间），应使用 sys_dumpall 。
sys_dump [``connection-option``...] [``option``...] [``dbname``]
常用参数：
dbname
指定要被转储的数据库名。
-a --data-only
只转储数据，而不转储模式（数据定义）。
-c --clean
在输出创建数据库对象的命令之前输出清除（删除）它们的命令。这个选项只对纯文本格式有意义。
-C --create
输出的开始是一个创建数据库本身并且重新连接到被创建的数据库的命令。
-E encoding --encoding=encoding
以指定的字符集编码创建转储。
-f file --file=file
将输出发送到指定文件。
-F format --format=format
选择输出的格式。``format``可以是下列之一：
p plain
输出一个纯文本形式的SQL脚本文件（默认值）。
c custom
输出一个适合于作为sys_restore输入的自定义格式归档。
d directory
输出一个适合作为sys_restore输入的目录格式归档。
t tar
输出一个适合于输入到sys_restore中的tar-格式归档。
-s --schema-only
只转储对象定义（模式），而非数据。
-t pattern --table=pattern
只转储名字匹配``pattern``的表。
-T pattern --exclude-table=pattern
不转储匹配``pattern``模式的任何表。
--column-inserts --attribute-inserts
将数据转储为带有显式列名的INSERT命令（INSERT INTO table (``column``, ...) VALUES ...）。
--inserts
将数据转储为INSERT命令（而不是COPY）。这将使得恢复非常慢，这主要用于使转储能够被载入到非KingbaseES数据库中。
--rows-per-insert=nrows
使用INSERT命令转储数据(而非 COPY). 控制INSERT每行的最大行数。
sys_dump示例
sys_dump导出可以被输出到脚本或归档文件格式两种格式。
脚本转储示例：
./sys_dump -Fp test1 -f /home/kingbase/backup/dumpFp.out -Usystem
导出数据库test1全部数据，到/home/kingbase/backup/dumpFp.out路径中。
./sys_dump -Fp -Cc test1 -f /home/kingbase/backup/dumpCc.out -Usystem
导出数据库test1全部数据，到/home/kingbase/backup/dumpCc.out路径中,数据sql中包含清除sql命令。
./sys_dump -Fp -Cc -E utf-8 test1 -f /home/kingbase/backup/dumpFpCcE.out -Usystem
导出数据库test1全部数据，到/home/kingbase/backup/dumpFpCcE.out路径中,数据sql中包含清除sql命令，并指定数据导出编码。
[kingbase@node128 backup]$ more dumpFpCcE.out
--
-- Kingbase database dump
--
-- Dumped from database version 12.1
-- Dumped by sys_dump version 12.1
SET statement_timeout = 0;
SET lock_timeout = 0;
SET idle_in_transaction_session_timeout = 0;
SET client_encoding = 'UTF8';
SET standard_conforming_strings = on;
SELECT pg_catalog.set_config('search_path', 'public', false);
SET check_function_bodies = false;
SET xmloption = content;
SET client_min_messages = warning;
SET row_security = off;
SET default_with_oids = off;
DROP DATABASE test1;
--
-- Name: test1; Type: DATABASE; Schema: -; Owner: system
--
CREATE DATABASE test1 WITH TEMPLATE = template0 ENCODING = 'UTF8' LC_COLLATE = 'zh_CN.UTF-8' LC_CTYPE = 'zh_CN.UTF-8';
ALTER DATABASE test1 OWNER TO system;
\connect test1
SET statement_timeout = 0;
SET lock_timeout = 0;
SET idle_in_transaction_session_timeout = 0;
SET client_encoding = 'UTF8';
SET standard_conforming_strings = on;
SELECT pg_catalog.set_config('search_path', 'public', false);
SET check_function_bodies = false;
SET xmloption = content;
SET client_min_messages = warning;
SET row_security = off;
SET default_with_oids = off;
sys_dump导出数据为纯文本形式的SQL脚本文件。它们可以用来重构数据库到它被转储时的状态。
脚本文件还可以被用来在其他机器和其他架构上重构数据库。在经过修改后，甚至可以在其他SQL数据库产品上重构数据库。
脚本格式可以使用ksql进行数据导入恢复。
./ksql -f /home/kingbase/backup/dumpFp.out -Usystem -d test
./sys_dump -Fp -Cc -E utf-8 --column-inserts --inserts --rows-per-insert=5 test1 -f /home/kingbase/backup/dumpFpCcEinserts.out -Usystem
导出数据库test1全部数据，到/home/kingbase/backup/dumpFp.out路径中。
数据导出格式为sql的insert格式，非数据库的copy格式。
column-inserts选项指定数据sql必须带列名inser into table（acol ，bcol）。
rows-per-insert指定每次insert的提交数据条数。
数据导出格式示例如下：
--
-- Data for Name: bigtable; Type: TABLE DATA; Schema: public; Owner: system
--
INSERT INTO public.bigtable (id, name, addr, bir) VALUES ****** column-inserts指定导出inert语句格式带列名
(1, 'name1', 'addr1', '2022-08-11 10:39:52'), ****** rows-per-insert指定每次提交5条数据
(2, 'name2', 'addr2', '2022-08-11 10:39:52'), ****** inserts指定insert数据，非copy方式
(3, 'name3', 'addr3', '2022-08-11 10:39:52'),
(4, 'name4', 'addr4', '2022-08-11 10:39:52'),
(5, 'name5', 'addr5', '2022-08-11 10:39:52');
INSERT INTO public.bigtable (id, name, addr, bir) VALUES
(6, 'name6', 'addr6', '2022-08-11 10:39:52'),
(7, 'name7', 'addr7', '2022-08-11 10:39:52'),
(8, 'name8', 'addr8', '2022-08-11 10:39:52'),
(9, 'name9', 'addr9', '2022-08-11 10:39:52'),
(10, 'name10', 'addr10', '2022-08-11 10:39:52');
INSERT INTO public.bigtable (id, name, addr, bir) VALUES
(11, 'name11', 'addr11', '2022-08-11 10:39:52'),
(12, 'name12', 'addr12', '2022-08-11 10:39:52'),
(13, 'name13', 'addr13', '2022-08-11 10:39:52'),
(14, 'name14', 'addr14', '2022-08-11 10:39:52'),
(15, 'name15', 'addr15', '2022-08-11 10:39:52');
归档文件格式：
归档文件格式必须与sys_restore配合使用来重建数据库。
./sys_dump -Fc -E utf-8 test1 -f /home/kingbase/backup/dumpFc.out -Usystem
导出数据库test1全部数据的自定义格式归档，到/home/kingbase/backup/dumpFc.out路径中。默认情况还会被压缩。
[kingbase@node128 backup]$ ll
总用量 356
-rw-rw-r-- 1 kingbase kingbase 56280 8月 11 15:23 dumpFc.out
./sys_dump -Fd -E utf-8 test1 -f /home/kingbase/backup/dumpFd -Usystem
导出数据库test1全部数据的目录格式归档，到/home/kingbase/backup/dumpFc.out路径中。默认情况下是被压缩的并且也支持并行转储。
[kingbase@node128 backup]$ ll
总用量 356
drwx------ 2 kingbase kingbase 135 8月 11 15:23 dumpFd
[kingbase@node128 backup]$ ll dumpFd
总用量 76
-rw-rw-r-- 1 kingbase kingbase 31 8月 11 15:23 5664.dat.gz
-rw-rw-r-- 1 kingbase kingbase 32 8月 11 15:23 5665.dat.gz
-rw-rw-r-- 1 kingbase kingbase 57 8月 11 15:23 5666.dat.gz
-rw-rw-r-- 1 kingbase kingbase 25 8月 11 15:23 5667.dat.gz
-rw-rw-r-- 1 kingbase kingbase 29 8月 11 15:23 5668.dat.gz
-rw-rw-r-- 1 kingbase kingbase 3524 8月 11 15:23 5669.dat.gz
-rw-rw-r-- 1 kingbase kingbase 51654 8月 11 15:23 toc.dat
./sys_dump -Ft -E utf-8 test1 -f /home/kingbase/backup/dumpFt.tar -Usystem
导出数据库test1全部数据的tar-格式归档，到/home/kingbase/backup/dumpFc.out路径中。tar 格式不支持压缩。
[kingbase@node128 backup]$ ll
总用量 356
-rw-rw-r-- 1 kingbase kingbase 119296 8月 11 15:23 dumpFt.tar
sys_restore 命令格式：：
sys_restore [``connection-option``...] [``option``...] [``filename``]
常用参数：
filename
指定要被恢复的归档文件（对于一个目录格式的归档则是目录）的位置。
-a --data-only
只转储数据，而不转储模式（数据定义）。
-c --clean
在输出创建数据库对象的命令之前输出清除（删除）它们的命令。
-C --create
在恢复一个数据库之前先创建它。
-d dbname --dbname=dbname
连接到数据库``dbname``并且直接恢复到该数据库中。
-f filename --file=filename
为生成的脚本或列表（当使用-l时）指定输出文件。
-F format --format=format
指定归档的格式。
c custom
归档是sys_dump的自定义格式。
d directory
归档是一个目录归档。
t tar
归档是一个tar归档。
-I index --index=index
只恢复提及的索引的定义。
-l --list
列出归档的内容的表格。
--view-only
只恢复视图。
-s --schema-only
只恢复归档中的模式（数据定义）不恢复数据。
sys_restore示例
数据恢复示例：
./sys_restore -Fc /home/kingbase/backup/dumpFc.out -Usystem -d test1
恢复数据库test1全部数据，在数据库中需要重新创建干净的test1数据库（create database test1 template template0）。
./sys_restore -Fc /home/kingbase/backup/dumpFc.out -Usystem -Cc -f /home/kingbase/backup/dumpFc.log
将数据库备份dumpFc.out文件导出到dumpFc.log中，并解析为sql文本格式（非导入数据库）。
./sys_restore -Fd /home/kingbase/backup/dumpFd -Usystem -d test1
恢复数据库test1全部数据，在数据库中需要重新创建干净的test1数据库（create database test1 template template0）。
./sys_restore -Fd /home/kingbase/backup/dumpFd -f /home/kingbase/backup/dumpFd.log -Usystem
将数据库备份dumpFd文件导出到dumpFd.log中，并解析为sql文本格式（非导入数据库）。
./sys_restore -Ft /home/kingbase/backup/dumpFt.tar -Usystem -d test1
恢复数据库test1全部数据，在数据库中需要重新创建干净的test1数据库（create database test1 template template0）。
./sys_restore -Ft /home/kingbase/backup/dumpFt.tar -f /home/kingbase/backup/dumpFt.log -Usystem
将数据库备份dumpFd文件导出到dumpFt.log中，并解析为sql文本格式（非导入数据库）。
KINGBASE研究院
