VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

backup命令

功能描述

创建指定实例的备份。

语法格式

vb_probackup backup -B backup_dir -b backup_mode --instance=instance_name
[--help] [-D pgdata-path] [-C] [--stream [-S slot_name] [--temp-slot]]
[--backup-pg-log] [-j num_threads] [--progress]
[--no-validate] [--skip-block-validation]
[-E external_directory_path] [--no-sync] [--note=text]
[connection_options] [compression_options] [remote_options]
[retention_options] [pinning_options] [logging_options]

参数说明:

  • -b:指定备份模式。取值有:

    • FULL:创建全量备份,全量备份包含所有数据文件。

    • PTRACK:动态创建增量备份跟踪页面更改。

  • -D:同–pgdata,指定数据库数据目录的路径。

  • -C:将检查点在一段时间内展开,默认情况下,vb_probackup会尝试尽快完成检查点。

  • -S slot_name, –slot=slot_name:指定WAL流处理的复制slot,此参数只能与-stream参数一起使用。

  • –temp-slot:在备份的实例中为WAL流处理创建一个临时物理复制slot,它确保在备份过程中,所有所需的WAL段仍然是可用的。此参数只能与–stream参数一起使用。默认的slot名为pg_probackup_slot,可通过选项–slot/-S更改。

  • –backup-pg-log:将日志目录包含到备份中。此目录通常包含日志消息。默认情况下不包含日志目录。

  • –j:设置备份、还原、合并进程的并行线程数。

  • –progress:显示进度。

  • –no-validate:跳过备份验证。

  • –skip-block-validation:跳过块级校验,以加快验证速度。在恢复之前的自动验证期间,将仅做文件级别的校验。

  • -E external-directories-paths, –external-dirs=external-directories-paths:将指定的目录包含到备份中。此选项对于备份位于数据目录外部的脚本、sql转储和配置文件很有用。如果要备份多个外部目录,请在Unix上用冒号分隔它们的路径。

  • –no-sync:不将备份文件同步到磁盘。

  • –note:给备份添加note。

  • connection_options选项的参数有:

    • -d:指定要连接的数据库名称。

    • -h:指定运行服务器的系统的主机名。

    • -p:指定服务器正在监听连接的TCP端口或本地Unix套接字的路径。

    • -U:指定连接数据库的用户名。

    • -w:不出现输入密码提示。如果主机要求密码认证并且密码没有通过其它形式给出,则连接尝试将会失败。

    • -W:强制出现输入密码提示。

  • compression_options选项的参数有:

    • –compress-algorithm:指定用于压缩数据文件的算法。默认值为none。

    • –compress-level:指定压缩级别。默认值为1。

    • –compress:以–compress-algorithm=zlib和–compress-level=1进行压缩。

  • retention_options选项的参数有:

    • –retention-redundancy:指定在数据目录中留存的完整备份数。必须为正整数。0表示禁用此设置。默认值为0。

    • –retention-window:指定留存的天数。必须为正整数。0表示禁用此设置。默认值为0。

    • –delete-expired:删除不符合pg_probackup.conf配置文件中定义的留存策略的备份。

    • –merge-expired:将满足留存策略要求的最旧的增量备份与其已过期的父备份合并。

    • –dry-run:显示所有可用备份的当前状态,不删除或合并过期备份。

  • pinning_options选项的参数有:

    • –ttl:指定从恢复时间开始计算,备份要固定的时间量。必须为正整数,0表示取消备份固定。

    • –expire-time:指定备份固定失效的时间戳。