参数说明
gs_basebackup 参数可以分为如下几类:
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
208
-D directory
备份文件输出的目录,必选项。
常用参数
-c,--checkpoint=fast|spread
设置检查点模式为fast 或者spread(默认)。
-l,--label=LABEL
为备份设置标签。
-P,--progress
启用进展报告。
-v,--verbose
启用冗长模式。
-V,--version
打印版本后退出。
-?,--help
显示gs_basebackup 命令行参数。
-T,--tablespace-mapping=olddir=newdir
在备份期间将目录olddir 中的表空间重定位到newdir 中。为使之有效,olddir 必须正好
匹配表空间所在的路径(但如果备份中没有包含olddir 中的表空间也不是错误)。olddir 和
newdir 必须是绝对路径。如果一个路径凑巧包含了一个=符号,可用反斜线对它转义。对于
多个表空间可以多次使用这个选项。
-F,--format=plain|tar
设置输出格式为plain(默认)或者tar。没有设置该参数的情况下,默认--format=plain。
plain 格式把输出写成平面文件,使用和当前数据目录和表空间相同的布局。当集簇没有额
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
209
外表空间时,整个数据库将被放在目标目录中。如果集簇包含额外的表空间,
主数据目录将
被放置在目标目录中,但是所有其他表空间将被放在它们位于服务器上的相同的绝对路径
中。tar 模式将输出写成目标目录中的tar 文件。主数据目录将被写入到一个名为base.tar
的文件中,并且其他表空间将被以其OID 命名。生成的tar 包,需要用gs_tar 命令解压。
-X,--xlog-method=fetch|stream
设置xlog 传输方式。没有设置该参数的情况下,默认--xlog-method=stream。在备份中
包括所需的预写式日志文件
(WAL 文件)
。
这包括所有在备份期间产生的预写式日志。
fetch
方式在备份末尾收集预写式日志文件。因此,有必要把wal_keep_segments 参数设置得足够
高,这样在备份末尾之前日志不会被移除。如果在要传输日志时它已经被轮转,备份将失败
并且是不可用的。
stream 方式在备份被创建时流传送预写式日志。
这将开启一个到服务器的
第二连接并且在运行备份时并行开始流传输预写式日志。因此,它将使用最多两个由
max_wal_senders 参数配置的连接。只要客户端能保持接收预写式日志,使用这种模式不需
要在主控机上保存额外的预写式日志。
-x,--xlog 使用这个选项等效于和方法fetch 一起使用-X。
-Z --compress=level
启用对tar 文件输出的gzip 压缩,并且制定压缩级别(0 到9,0 是不压缩,9 是最
佳压缩)
。
只有使用tar 格式时压缩才可用,
并且会在所有tar 文件名后面自动加上后缀.gz。
-z
启用对tar 文件输出的gzip 压缩,使用默认的压缩级别。只有使用tar 格式时压缩才
可用,并且会在所有tar 文件名后面自动加上后缀.gz。
-t,--rw-timeout
设置备份期间checkpoint 的时间限制,默认限制时间为120s。当数据库全量checkpoint
耗时较长时,可以适当增大rw-timeout 限制时间。
连接参数
-h, --host=HOSTNAME
GBase 8c 工具参考手册
南大通用数据技术股份有限公司
210
指定正在运行服务器的主机名或者Unix 域套接字的路径。
-p,--port=PORT
指定数据库服务器的端口号。
可以通过port 参数修改默认端口号。
-U,--username=USERNAME
指定连接数据库的用户。
-s, --status-interval=INTERVAL
发送到服务器的状态包的时间(以秒为单位)。
-w,--no-password
不出现输入密码提示。
-W, --password
当使用-U 参数连接本地数据库或者连接远端数据库时,可通过指定该选项出现输入密
码提示。