目录
一、测试环境
二、介绍
三、命令帮助
四、参数介绍
1、--print-defaults
（1）含义
（2）例子
2、--connect_timeout
（1）含义
（2）例子
3、-A, --all-databases
（1）含义
（2）例子
4、-s, --system-databases
（1）含义
（2）例子
5、-U, --user-databases
（1）含义
（2）例子
6、--default-character-set
（1）含义
（2）例子
7、--character-sets-dir
（1）含义
8、-i, --comments
（1）含义
（2）例子
9、-B, --databases
（1）含义
（2）例子
10、-f, --force
（1）含义
（2）例子
11、-h, --host
（1）含义
（2）例子
12、--ignore-table
（1）含义
（2）例子
13、--log-error
（1）含义
（2）例子
14、-n, --no-create-db
（1）含义
（2）例子
15、-t, --no-create-info
（1）含义
（2）例子
16、-p, --password
（1）含义
（2）例子
17、-P, --port
（1）含义
（2）例子
18、--protocol
（1）含义
（2）例子
19、-q, --quick
（1）含义
（2）例子
20、-Q, --quote-names
（1）含义
（2）例子
21、--replace
（1）含义
22、-r, --result-file
（1）含义
（2）例子
23、-R, --routines
（1）含义
（2）例子
24、-F, --file-path
（1）含义
（2）例子
25、--set-charset
（1）含义
（2）例子
26、-O, --set-variable
（1）含义
27、-I, --colId
（1）含义
（2）例子
28、-S, --socket
（1）含义
29、-u, --user
（1）含义
（2）例子
30、-V, --version
（1）含义
（2）例子
一、测试环境
| 名称 | 值 |
| CPU | Intel(R) Core(TM) i5-1035G1 CPU @ 1.00GHz |
| 操作系统 | CentOS Linux release 7.9.2009 (Core) |
| 内存 | 3G |
| 逻辑核数 | 2 |
| Gbase8a版本 | 8.6.2-R43 |
二、介绍
gcdump工具支持导出表、自定义函数、自定义存储过程、python外部函数等数据库对象，但不支持导出数据，需要导出数据的小伙伴可以之前写的文章《南大通用数据库-Gbase-8a-学习-14-LOAD加载数据》
三、命令帮助
[gbase@czg2 Select]$ gcdump --help
gcdump ver 8.6.2-R43.34.27468a27, for redhat-linux (x86_64)
Dumping definition and data gbase database or table
Usage: gcdump [OPTIONS] database [tables]
OR gcdump [OPTIONS] --databases [OPTIONS] DB1 [DB2 DB3...]
OR gcdump [OPTIONS] --all-databases [OPTIONS]
The following groups are read: gbasedump client
The following options may be given as the first argument:
--print-defaults Print the program argument list and exit
--no-defaults Don't read default options from any options file
--defaults-file=# Only read default options from the given file #
--defaults-extra-file=# Read this file after the global files are read
--connect_timeout=# Number of seconds before connection timeout.
-A, --all-databases Dump all the databases. This will be same as --databases
with all databases selected.
-s, --system-databases
Dump system databases.
-U, --user-databases
Dump all fixed user databases.
--default-character-set=name
Set the default character set.
--character-sets-dir=name
Directory where character sets are.
-i, --comments Write additional information.
--net_buffer_length=#
-B, --databases To dump several databases. Note the difference in usage;
In this case no tables are given. All name arguments are
regarded as databasenames. 'USE db_name;' will be
included in the output.
-f, --force Continue even if we get an sql-error.
-?, --help Display this help message and exit.
-h, --host=name Connect to host.
--ignore-table=name Do not dump the specified table. To specify more than one
table to ignore, use the directive multiple times, once
for each table. Each table must be specified with both
database and table names, e.g.
--ignore-table=database.table
--log-error[=name] Append warnings and errors to given file.
--max_allowed_packet=#
-n, --no-create-db 'CREATE DATABASE IF NOT EXISTS db_name;' will not be put
in the output. The above line will be added otherwise, if
--databases or --all-databases option was given.}.
-t, --no-create-info
Don't write table creation info.
-p, --password[=name]
Password to use when connecting to server. If password is
not given it's solicited on the tty.
-P, --port=# Port number to use for connection.
--protocol=name The protocol of connection (tcp,socket,pipe,memory).
-q, --quick Don't buffer query, dump directly to stdout.
-Q, --quote-names Quote table and column names with backticks (`).
--replace Use REPLACE INTO instead of INSERT INTO.
-r, --result-file=name
Direct output to a given file. This option should be used
in MSDOS, because it prevents new line '\n' from being
converted to '\r\n' (carriage return + line feed).
-R, --routines Dump stored routines (functions and procedures).
-F, --file-path=name
For local temp file
--set-charset Add 'SET NAMES default_character_set' to the output.
Enabled by default; suppress with --skip-set-charset.
-O, --set-variable=name
Change the value of a variable. Please note that this
option is deprecated; you can set variables directly with
--variable-name=value.
-S, --socket=name Socket file to use for connection.
-u, --user=name User for login if not current user.
-V, --version Output version information and exit.
-I, --colId Show TID and COLUMN_IDS.
Variables (--variable-name=value)
and boolean options {FALSE|TRUE} Value (after reading options)
--------------------------------- -----------------------------
connect_timeout 43200
all-databases FALSE
system-databases FALSE
user-databases FALSE
default-character-set utf8
character-sets-dir (No default value)
comments TRUE
net_buffer_length 1046528
databases FALSE
force FALSE
host (No default value)
max_allowed_packet 67108864
no-create-db FALSE
no-create-info FALSE
port 5258
quick TRUE
quote-names TRUE
replace FALSE
routines FALSE
set-charset TRUE
socket /tmp/gcluster_5258.sock
user (No default value)四、参数介绍
1、--print-defaults
（1）含义
打印程序参数列表并退出。
（2）例子
[gbase@czg2 Select]$ gcdump --print-defaults
gcdump would have been started with the following arguments:
--port=5258 --socket=/tmp/gcluster_5258.sock --connect_timeout=43200 --max_allowed_packet=64M2、--connect_timeout
（1）含义
连接超时前的秒数。
（2）例子
[gbase@czg2 ~]$ gcdump --connect_timeout=10 -h 192.168.142.12 -U zxj > gcdump_2023_04_25.txt
[gbase@czg2 ~]$ ll
总用量 84996
-rw-rw-rw- 1 gbase gbase 36 3月 31 16:33 ALLDbVoidRate.txt
-rw-rw-r-- 1 gbase gbase 9958 4月 25 09:38 gcdump_2023_04_25.txt
-rw-r--r-- 1 root root 87013244 8月 23 2022 gcluster_backup_20220823111929.tar.bz2
drwxr-xr-x 6 gbase gbase 154 11月 16 17:51 gcmonitor_agent
drwxr-xr-x 6 gbase gbase 194 11月 16 17:33 gcmonitor_center
-rw-rw-r-- 1 gbase gbase 152 3月 29 11:11 Sql.txt
drwxrwxr-x 3 gbase gbase 28 9月 21 2022 tablespace_10m3、-A, --all-databases
（1）含义
转储所有数据库,但不包含系统库。这将与--databases相同选择了所有数据库。
（2）例子
[gbase@czg2 ~]$ gcdump --connect_timeout=10 -h 192.168.142.12 -A > gcdump_2023_04_25.txt
2023-04-25 09:41:10.831 gcdump: /*warning: information_schema is system db, don't hold export!*/
2023-04-25 09:41:10.831 gcdump: /*warning: performance_schema is system db, don't hold export!*/
2023-04-25 09:41:10.941 gcdump: /*warning: gbase is system db, don't hold export!*/
2023-04-25 09:41:10.941 gcdump: /*warning: gclusterdb is system db, don't hold export!*/
2023-04-25 09:41:10.941 gcdump: /*warning: gctmpdb is system db, don't hold export!*/ 4、-s, --system-databases
（1）含义
导出系统库，会有报错提示：gbase.drop_temp_table不支持任何操作。后续我再摸索一下。
（2）例子
[gbase@czg2 ~]$ gcdump --connect_timeout=10 -h 192.168.142.12 -f -s > gcdump_2023_04_25.txt
2023-04-25 09:45:40.725 gcdump: Couldn't execute 'SHOW CREATE EVENT `drop_temp_table`': (GBA-01-600) Gbase internal error: gbase.drop_temp_table is system fixed event,not support any operator (1732)
[gbase@czg2 ~]$ tail -100 gcdump_2023_04_25.txt
--
-- Dumping events for database 'gbase'
--5、-U, --user-databases
（1）含义
转储所有固定用户数据库。
也就是把所有用户自建库的对象定义都导出。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -U > gcdump_2023_04_25.txt6、--default-character-set
（1）含义
设置导出文件的默认字符集。
（2）例子
测试utf8字符集
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -U --default-character-set=utf8 > gcdump_2023_04_25.txt 
测试gbk字符集
[gbase@czg2 gcdump -h 192.168.142.12 -U --default-character-set=gbk > gcdump_2023_04_25_gbk.txt
7、--character-sets-dir
（1）含义
安装字符集的目录。具体用法后续摸索一下。
8、-i, --comments
（1）含义
编写附加信息。
加与不加区别不大。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -i > gcdump_2023_04_25_gbk.txt
9、-B, --databases
（1）含义
转储多个数据库。注意用法上的差异；
在这种情况下，没有给出表格。所有名称参数都是被视为数据库名字。'USE db_name;'将包括在输出中。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj czg -i > gcdump_2023_04_25_gbk.txt
10、-f, --force
（1）含义
即使出现sql错误，也要继续。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj czg -f > gcdump_2023_04_25_gbk.txt11、-h, --host
（1）含义
连接的主机IP。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj czg -f > gcdump_2023_04_25_gbk.txt12、--ignore-table
（1）含义
不要转储指定的表。指定多个要忽略的表，多次使用该指令，一次一个表。每个表都必须同时指定数据库和表名。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj czg -f > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ cat gcdump_2023_04_25_gbk.txt |grep testtab
DROP TABLE IF EXISTS `testtab`;
CREATE TABLE `testtab` (
KEY `testtab_index_a` (`a`) USING HASH GLOBAL,
KEY `testtab_index_c` (`c`) USING HASH GLOBAL
DROP TABLE IF EXISTS `testtab_copy`;
CREATE TABLE `testtab_copy` (
KEY `testtab_c_index_a` (`a`) USING HASH GLOBAL
DROP TABLE IF EXISTS `testtab`;
CREATE TABLE `testtab` (
KEY `testtab_index_c` (`c`) USING HASH GLOBAL
DROP TABLE IF EXISTS `testtab_copy`;
CREATE TABLE `testtab_copy` (
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj czg --ignore-table=czg.testtab --ignore-table=czg.testtab_copy --ignore-table=zxj.testtab --ignore-table=zxj.testtab_copy -f > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ cat gcdump_2023_04_25_gbk.txt |grep testtab13、--log-error
（1）含义
将警告和错误附加到给定的文件中。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj --log-error=LogError.log > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ ll
总用量 84988
-rw-rw-rw- 1 gbase gbase 36 3月 31 16:33 ALLDbVoidRate.txt
-rw-rw-r-- 1 gbase gbase 4089 4月 25 10:41 gcdump_2023_04_25_gbk.txt
-rw-r--r-- 1 root root 87013244 8月 23 2022 gcluster_backup_20220823111929.tar.bz2
drwxr-xr-x 6 gbase gbase 154 11月 16 17:51 gcmonitor_agent
drwxr-xr-x 6 gbase gbase 194 11月 16 17:33 gcmonitor_center
-rw-rw-r-- 1 gbase gbase 0 4月 25 10:41 LogError.log
-rw-rw-r-- 1 gbase gbase 152 3月 29 11:11 Sql.txt
drwxrwxr-x 3 gbase gbase 28 9月 21 2022 tablespace_10m14、-n, --no-create-db
（1）含义
'CREATE DATABASE IF NOT EXISTS db_name;'不会被放置在输出中。如果--databases或--all databases选项给出。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ cat gcdump_2023_04_25_gbk.txt |grep 'CREATE DATABASE'
CREATE DATABASE IF NOT EXISTS `zxj` DEFAULT CHARACTER SET utf8;
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -n > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ cat gcdump_2023_04_25_gbk.txt |grep 'CREATE DATABASE'15、-t, --no-create-info
（1）含义
不要写入表创建信息。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -t > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ cat gcdump_2023_04_25_gbk.txt
DROP DATABASE IF EXISTS `zxj`;
CREATE DATABASE IF NOT EXISTS `zxj` DEFAULT CHARACTER SET utf8;
USE `zxj`;
--
-- Dumping events for database 'zxj'
--
USE `zxj`;16、-p, --password
（1）含义
连接到服务器时要使用的密码。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -u czg > gcdump_2023_04_25_gbk.txt
2023-04-25 10:51:46.901 gcdump: Got error: 1045: Access denied for user 'czg'@'192.168.142.12' (using password: NO) when trying to connect
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -u czg -pqwer1234 > gcdump_2023_04_25_gbk.txt17、-P, --port
（1）含义
连接数据库的端口号。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -u czg -pqwer1234 -P 5258 > gcdump_2023_04_25_gbk.txt18、--protocol
（1）含义
连接的协议(tcp,socket,pipe,memory)（tcp、套接字、管道、内存）。
套接字、管道、内存没有测试过。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj --protocol=tcp > gcdump_2023_04_25_gbk.txt19、-q, --quick
（1）含义
不缓冲查询，直接转储到stdout。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -q > gcdump_2023_04_25_gbk.txt20、-Q, --quote-names
（1）含义
用反引号（`）引用表名和列名。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -Q > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ tail -10 gcdump_2023_04_25_gbk.txt
`a` int(11) DEFAULT NULL,
`b` double DEFAULT NULL,
`c` varchar(100) DEFAULT NULL,
`d` text,
`e` blob,
`f` longblob,
`g` date DEFAULT NULL,
`h` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
KEY `testtab_c_index_a` (`a`) USING HASH GLOBAL
) ENGINE=EXPRESS DEFAULT CHARSET=utf8 TABLESPACE='sys_tablespace';21、--replace
（1）含义
使用REPLACE INTO而不是INSERT INTO。
Gbase不支持导出数据，所以可以忽略这个参数。
22、-r, --result-file
（1）含义
直接输出到给定的文件。应使用此选项在MSDOS中，因为它阻止新行“\n”已转换为“\r\n”（回车+换行）。
此参数不生效，会生成一个空文件。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B zxj -r gcdump_2023_04_25_gbk.txt23、-R, --routines
（1）含义
导出自定义存储过程和函数。
此参数不生效，会生成一个空文件。
-B导出一个库时，加不加-R都导出自定义存储过程和函数。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -R > gcdump_2023_04_25_gbk.txt24、-F, --file-path
（1）含义
生成本地临时文件
（2）例子
[gbase@czg2 ~]$ mkdir gcdump_file
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B czg -F gcdump_file
[gbase@czg2 ~]$ ll gcdump_file/czg/
总用量 8
-rw-rw-r-- 1 gbase gbase 4665 4月 25 11:13 create_db.sql
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_a
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_alldbvoidrate
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_b
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_czg
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_czg_test
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_d_admin_kpi_code
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_hash_tb_like
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_moon
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_moon_copy
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_sun
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test_12_05
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test20230302
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_testtab
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_testtab_copy
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test_table
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test_table_1
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test_table_2
drwxrwxr-x 3 gbase gbase 18 4月 25 11:13 t_test_table_3
[gbase@czg2 ~]$ cat gcdump_file/czg/t_sun/meta/create_tb.sql
use czg;
DROP TABLE IF EXISTS `sun`;
CREATE TABLE `sun` (
`a` int(11) DEFAULT NULL
) ENGINE=EXPRESS DEFAULT CHARSET=utf8 TABLESPACE='sys_tablespace';25、--set-charset
（1）含义
添加'SET NAMES default_character_set'到输出中。
默认启用；使用--skip-set-charset抑制。
测试不生效。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B czg --set-charset > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ cat gcdump_2023_04_25_gbk.txt |grep 'SET NAMES'26、-O, --set-variable
（1）含义
更改变量的值。请注意
选项已弃用；可以使用直接设置变量--variable-name=value。
27、-I, --colId
（1）含义
展示TID and COLUMN_IDS。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B czg -I > gcdump_2023_04_25_gbk.txt
[gbase@czg2 ~]$ tail -10 gcdump_2023_04_25_gbk.txt
CREATE TABLE `testtab_copy` (
`a` int(11) DEFAULT NULL,
`b` double DEFAULT NULL,
`c` varchar(100) DEFAULT NULL,
`d` text,
`e` blob,
`f` longblob,
`g` date DEFAULT NULL,
`h` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
) ENGINE=EXPRESS TID(6147) UID(1) DEFAULT CHARSET=utf8 TABLESPACE='sys_tablespace' COLUMN_IDS(0, 1, 2, 3, 4, 5, 6, 7);28、-S, --socket
（1）含义
用于连接的套接字文件。
29、-u, --user
（1）含义
用于登录的用户（如果不是当前用户）。
（2）例子
[gbase@czg2 ~]$ gcdump -h 192.168.142.12 -B czg -u czg -pqwer1234 > gcdump_2023_04_25_gbk.txt30、-V, --version
（1）含义
输出版本信息，然后退出。
（2）例子
[gbase@czg2 ~]$ gcdump -V
gcdump ver 8.6.2-R43.34.27468a27, for redhat-linux (x86_64)
