目录
10.1.7. --tablespace-map-all ¶
10.2.12. --tcp-keep-alive-count ¶
10.2.13. --tcp-keep-alive-idle ¶
10.2.14. --tcp-keep-alive-interval ¶
restore命令将还原数据库实例，并设置数据库实例第一次启动时的恢复参数。
10.1. Command 选项 ¶
10.1.1. --archive-mode ¶
设置还原后的KingbaseES数据库的archive_mode。
支持以下配置：
off 还原后强制设置为off
preserve 还原后保留备份时的设置
默认: preserve
举例: --archive-mode=off
10.1.2. --force ¶
设置还原时强制覆盖目标DATA目录已有的文件。
默认: n
举例: --force
10.1.3. --link-all ¶
开启对DATA目录下软链接的保留。
开启式，还原后的DATA目录下保留所有的软链接；
默认时，还原后的DATA目录下去除软链接，生成实际文件或文件夹。
默认: n
举例: --link-all
10.1.4. --link-map ¶
设置软链接在还原后指向新的目录。
本选项可以多次配置。
举例: --link-map=sys_wal=/data/sys_wal
10.1.5. --set ¶
设置还原时选择指定的备份集。
不指定时工具将选择最新的备份集。
默认: latest
举例: --set=20210131-153358F_20210131-153401I
10.1.6. --tablespace-map ¶
设置表空间在还原后实际指向新的目标文件夹。
该选项可以多次设置。
举例: --tablespace-map=ts_01=/db/ts_01
10.1.7. --tablespace-map-all ¶
设置所有表空间在还原后实际指向新的目标文件夹。
举例: --tablespace-map-all=/data/tablespace
10.1.8. --target ¶
设置还原后恢复行为的目标。
根据还原时选项--type的不同，--target选项可以是时间、标签、xid、lsn等。
举例: --target=2015-01-30 14:15:11 EST
10.1.9. --target-action ¶
设置还原后恢复完毕之后的数据库实例状态。
支持以下选项：
pause 当恢复到指定目标后暂停数据库实例
promote 当恢复到指定目标后，数据库进入读写状态并切换时间线。
shutdown 当恢复到指定目标后关闭数据库实例
NOTE：
此选项仅在数据库实例的配置hot_standby=on生效；如果没有此配置，数据库实例将进入读写状态并切换时间线。
默认: pause
举例: --target-action=promote
10.1.10. --target-exclusive ¶
设置是否在还原后的恢复阶段包含--target指定的内容。
默认是包含等于 --target 的内容。
举例说明:
--type=xid --target=1007 将恢复到等于1007的内容
--type=xid --target=1007 --target-exclusive将恢复到小于1007的内容
默认: n
举例: --target-exclusive
10.1.11. --target-timeline ¶
设置还原后用于恢复的时间线。
更多信息请参考KingbaseES手册中的recovery_target_timeline选项。
举例: --target-timeline=3
10.1.12. --type ¶
指定还原时的恢复目标类型。
支持以下选项：
default - 恢复到归档WAL日志的末尾
immediate - 不拉取归档的WAL日志
lsn - 恢复到--target指定lsn
name - 恢复到--target指定备份标记点(backup_label)
xid - 恢复到--target指定xid
time - 恢复到--target指定自然时间
preserve - 保留原有的kingbase.auto.conf文件
standby - 在kingbase.auto.conf中增加standby_mode=on
none - 不产生kingbase.auto.conf文件
默认: default
举例: --type=xid
10.2. General 选项 ¶
10.2.1. --buffer-size ¶
通用的I/O buffer容量，该容量应用于磁盘IO和网络IO的拷贝、压缩、加密及其他操作。
单位默认为字节，推荐使用KiB, MiB, GiB, TiB, PiB等后缀，均以1024为阶梯。
举例来说，5368709120 == 5GiB == 5GB == 5g 。
分数不被允许，比如2.5MiB不允许，可以使用2560KiB代替。
默认值： 1MiB
允许范围：16KiB,32KiB,64KiB,128KiB,256KiB,512KiB,1MiB,2MiB,4MiB,8MiB,16MiB
举例：--buffer-size=2MiB
10.2.2. --cmd ¶
设置sys_rman命令的全路径位置，或者指向外部包装脚本。
例如，在kingbase恢复的过程中，restore_command中使用archive-get命令时，可以使用外部包装脚本。
NOTE:
包装脚本具有一定的不确定性，不推荐使用。
举例：--cmd=/var/lib/pgsql/bin/sys_rman_wrapper.sh
10.2.3. --cmd-ssh ¶
设置ssh客户端的二进制文件位置。
默认: ssh
举例: --cmd-ssh=/usr/bin/ssh
10.2.4. --config ¶
sys_rman工具的主要配置文件。
命令行指定的选项优先于配置文件中的设定值。
举例: --config=/conf/sys_rman/sys_rman.conf
10.2.5. --delta ¶
开启通过目标文件的checksum来判断是否拷贝。
开启后，备份时根据文件的checksum来判断是否拷贝文件；
开启后，还原时根据文件的checksum来判断是否覆盖文件。
默认: n
举例: --delta
10.2.6. --io-timeout ¶
I/O超时时间，应用于建立连接、读、写操作等。
请注意，超时的范围，并不是指整个读写操作的完成，而是读写有进展；读写如果毫无进展且持续了设定的时间，则认为是I/O超时。
默认: 60
允许范围: 0.1-3600
举例: --io-timeout=120
10.2.7. --lock-path ¶
sys_rman工具排斥锁路径。
工具为了避免同样的环境下同时运行，将设置一个文件标识锁，lock-path用来指定文件锁的路径。
默认: /tmp/sys_rman
举例: --lock-path=/backup/db/lock
10.2.8. --process-max ¶
并发运行的最大进程数。
应用于拷贝文件、压缩等核心过程。
适当的设置可以提高备份或还原的效率，太高的设置会影响数据库实例本身的性能。
建议以CPU内核数设置最大进程数。
默认: 1
可选范围: 1-999
举例: --process-max=4
10.2.9. --protocol-timeout ¶
sys_rman协议超时时间，应用于sys_rman进程之间通讯协议，包含本地和远程进程。
NOTE： protocol-timeout应该大于db-timeout的时间。
默认: 1830
允许范围: 0.1-604800
举例: --protocol-timeout=630
10.2.10. --sck-keep-alive ¶
Socket心跳机制，允许在socket连接上启动心跳机制。
默认: y
举例: --no-sck-keep-alive
10.2.11. --stanza ¶
Stanza标签选项。
Stanza标签用来标识一个KingbaseES实例或集群，对sys_rman工具来说，一个标签对应于一个整体，包含若干DB节点。
举例: --stanza=kingbase
10.2.12. --tcp-keep-alive-count ¶
TCP心跳次数设置，如果心跳信息丢失的数目超过了这个设置，工具认为此连接已经断开。
允许范围: 1-32
举例: --tcp-keep-alive-count=3
10.2.13. --tcp-keep-alive-idle ¶
TCP心跳消息间隔时间，以秒为单位。
允许范围: 1-3600
举例: --tcp-keep-alive-idle=60
10.2.14. --tcp-keep-alive-interval ¶
TCP心跳消息重试时间，以秒为单位。
允许范围: 1-900
举例: --tcp-keep-alive-interval=30
10.3. Log 选项 ¶
10.3.1. --log-level-console ¶
屏幕输出日志级别。
支持以下日志级别：
off - 无任何日志（不推荐）
error - 只记录error级别
warn - 记录warning、error级别
info - 记录info、warning、error级别
detail- 记录detail、info、warning、error级别
debug - 记录debug、detail、info、warning、error级别
trace - 记录trace、debug、detail、info、warning、error级别
默认: warn
举例: --log-level-console=error
10.3.2. --log-level-file ¶
日志文件输出日志级别。
支持以下日志级别：
off - 无任何日志（不推荐）
error - 只记录error级别
warn - 记录warning、error级别
info - 记录info、warning、error级别
detail- 记录detail、info、warning、error级别
debug - 记录debug、detail、info、warning、error级别
trace - 记录trace、debug、detail、info、warning、error级别
默认: info
举例: --log-level-file=debug
10.3.3. --log-path ¶
工具的日志文件存放路径。
默认: /var/log/sys_rman
举例: --log-path=/backup/db/log
10.3.4. --log-subprocess ¶
开启记录子进程日志到日志文件，日志级别引用--log-level-file。
默认: n
举例: --log-subprocess
10.3.5. --log-timestamp ¶
开启在屏幕日志和文件日志中添加时间戳。
默认: y
举例: --no-log-timestamp
10.4. Repository 选项 ¶
10.4.1. --repo-cipher-type ¶
开启备份仓库的加密存储。
支持以下选项：
none 备份仓库不加密
aes-256-cbc 备份仓库使用Advanced Encryption Standard加密
默认: none
举例: --repo1-cipher-type=aes-256-cbc
10.4.2. --repo-host ¶
REPO节点的IP地址或主机名。
如果使用SSH访问的方式，在REPO节点和DB节点之间，预先建立好SSH免密登录。
举例: --repo1-host=repo1.domain.com
10.4.3. --repo-host-cmd ¶
设置REPO节点上sys_rman工具的全路径位置。
推荐在REPO节点和DB节点，sys_rman位于相同的路径之下；如果不一样，可以通过此选项来设置。
举例: --repo1-host-cmd=/usr/lib/backrest/bin/sys_rman
10.4.4. --repo-host-config ¶
设置REPO节点上的配置文件的全路径位置。
推荐在REPO节点和DB节点，配置文件位于相同的路径之下；如果不一样，可以通过此选项来设置不同的配置文件。
举例: --repo1-host-config=/conf/sys_rman/sys_rman.conf
10.4.5. --repo-host-port ¶
设置REPO节点的SSH端口。
默认：22
允许范围: 0-65535
举例: --repo1-host-port=25
10.4.6. --repo-host-user ¶
设置REPO节点的操作系统用户名。
举例: --repo1-host-user=repo-user
10.4.7. --repo-path ¶
设置REPO节点的实际存储目录。
可以是REPO节点的本地存储，可以是网络存储的本地挂载点。
物理备份和归档的WAL日志都将存储到此目录下。
举例: --repo1-path=/backup/db/repo
10.5. Stanza 选项 ¶
10.5.1. --kb-host ¶
设置DB节点的IP地址或主机名。
如果使用SSH访问的方式，在DB节点和REPO节点之间，预先建立好SSH免密登录。
举例: --kb1-host=db1.domain.com
10.5.2. --kb-path ¶
设置DB节点的data全路径，要求设置全路径地址，不使用相对路径。
举例: --kb1-path=/data/db
2060
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
