logo - 跳到首页

VastbaseG100

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

Menu

restore命令

功能描述

将备份文件恢复到指定实例。

语法格式

vb_probackup restore -B backup_dir --instance instance_name
[--help] [-D data_dir] [-i backup_id] [-j num_threads] [--progress]
[-T OLDDIR=NEWDIR] [--external-mapping=OLDDIR=NEWDIR] [--skip-external-dirs] [-I incremental_mode]
[-R | --restore-as-replica] [--no-validate] [--skip-block-validation] [--force]
[--restore-command=cmdline]
[recovery_options] [logging_options] [remote_options]

参数说明：

  • -B：备份路径。

  • -D ：数据目录的路径。

  • -i backup-id, –backup-id=backup-id：备份的唯一标识。

  • -j threads_num, –threads=threads_num：设置备份、还原、合并进程的并行线程数。

  • –progress：显示进度。

  • -T：恢复时将表空间从OLDDIR迁移到NEWDIR目录，当-T参数值为外部表空间目录时，必须搭配–external-mapping参数使用。

  • –external-mapping：在恢复时将备份中包含的外部目录从OLDDIR迁移到NEWDIR目录。

  • –skip-external-dirs：跳过备份中包含的使用–external-dirs选项指定的外部目录。这些目录的内容将不会被恢复。

  • -I：指定要使用的增量模式。

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

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

  • -R：创建最小恢复配置文件以帮助设置备用服务器。

  • –force：允许忽略备份的无效状态。如果出于某种原因需要从损坏的或无效的备份中恢复数据，可以使用此标志。请谨慎使用。

  • recovery_options选项的参数有：

    • –recovery-target-lsn=lsn：指定要恢复到的lsn，当前只能指定备份的stop lsn。

    • –recovery-target-name=target-name：指定要将数据恢复到的已命名的保存点，保存点可以通过查看备份中recovery-name字段得到。

    • –recovery-target-time=time：指定要恢复到的时间，当前只能指定备份中的recovery-time。

    • –recovery-target-xid=xid：指定要恢复到的事务ID，当前只能指定备份中的recovery-xid。

    • –recovery-target-inclusive=boolean：当该参数指定为true时，恢复目标将包括指定的内容。当该参数指定为false时，恢复目标将不包括指定的内容。该参数必须和–recovery-target-name、–recovery-target-time、–recovery-target-lsn或–recovery-target-xid一起使用。

  • logging_options选项的参数有：

    日志级别：verbose、log、info、warning、error和off。

    • –log-level-console=log-level-console：设置要发送到控制台的日志级别。每个级别都包含其后的所有级别。级别越高，发送的消息越少。指定off级别表示禁用控制台日志记录。默认值：info。

    • –log-level-file=log-level-file：设置要发送到日志文件的日志级别。每个级别都包含其后的所有级别。级别越高，发送的消息越少。指定off级别表示禁用日志文件记录。默认值：off。

    • –log-filename=log-filename：指定要创建的日志文件的文件名。文件名可以使用strftime模式，因此可以使用%-escapes指定随时间变化的文件名。 例如，如果指定了“pg_probackup-%u.log”模式，则pg_probackup为每周的每一天生成 单独的日志文件，其中%u替换为相应的十进制数字，即pg_probackup-1.log表示星期 一；pg_probackup-2.log表示星期二，以此类推。 如果指定了–log-level-file参数启用日志文件记录，则该参数有效。默认值：“pg_probackup.log”。

    • –error-log-filename=error-log-filename：指定仅用于error日志的日志文件名。指定方式与–log-filename参数相同。此参数用于故障排除和监视。

    • –log-directory=log-directory：指定创建日志文件的目录。必须是绝对路径。此目录会在写入第一条日志时创建。默认值：$BACKUP_PATH/log。

    • –log-rotation-size=log-rotation-size：指定单个日志文件的最大大小。如果达到此值，则启动gs_probackup命令后，日志文件将循环，但help和version命令除外。0表示禁用基于文件大小的循环。支持的单位：KB、MB、GB、TB（默认为KB）。默认值：0。

    • –log-rotation-age=log-rotation-age：单个日志文件的最大生命周期。如果达到此值，则启动gs_probackup命令后，日志文件将循环，但help和version命令除外。$BACKUP_PATH/log/log_rotation目录下保存最后一次创建日志文件的时间。0表示禁用基于时间的循环。支持的单位：ms, s, min, h, d（默认为min）。默认值：0。

  • remote_options选项的参数有：

    说明：:通过SSH远程运行gs_probackup操作的相关参数。可以和add-instance、set-config、backup、restore命令一起使用这些参数。

    • –remote-host=destination：指定要连接的远程主机的IP地址或主机名。

    • –remote-port=port：指定要连接的远程主机的端口号。默认值：22。

    • –remote-user=username：指定SSH连接的远程主机用户。如果省略此参数，则使用当前发起SSH连接的用户。默认值：当前用户。

    • –remote-path=path：指定gs_probackup在远程系统的安装目录。默认值：当前路径。

    • –remote-libpath=libpath：指定gs_probackup在远程系统安装的lib库目录。

    • –remote-proto=protocol：指定用于远程操作的协议。目前只支持SSH协议。取值包括：

      • ssh：通过SSH启用远程备份模式。这是默认值。
      • none：显式禁用远程模式。

      注意：如果指定了–remote-host参数，可以省略此参数。

    • –ssh-options=ssh_options：指定SSH命令行参数的字符串（例如：–ssh-options='-c cipher_spec -F configfile'）。