vbr 引用

vbr 让您能够备份和还原完整数据库，或者一个或多个相关的架构和表对象。您还可以复制一个群集以及列出之前创建的备份。

大多数任务不能同时运行；但是，复制任务既可彼此同时运行，也可以与备份任务同时运行。并发任务不能使用相同的快照名称。

vbr 位于 Vertica 二进制目录中（在大多数安装中，为 /opt/vertica/bin/vbr）。

语法

/opt/vertica/bin/vbr { command }
   [ --archive timestamp ]
   [ --config-file file ]
   [ --debug level]
   [ --nodes node[,...] ]
   [ --showconfig ]

command 是以下命令之一：

‑‑help | -h
显示命令的简短用法指南。
‑‑showconfig
显示当前配置设置。
‑‑task | -t { backup | collect-garbage | copycluster | full-check | init | listbackup | quick-check | quick-repair | remove | replicate | restore }
执行指定任务：

  • backup 根据配置文件规范创建完整数据库或对象级别备份。

  • collect-garbage 重建备份清单并删除备份位置中的任何未引用对象。

  • copycluster （Eon 模式数据库不支持）将数据库复制到另一个 Vertica 群集。

  • full-check 根据文件系统元数据验证备份清单中列出的所有对象，然后输出缺失的和未引用的对象。

  • init 创建新的备份目录，或者准备现有的备份目录以供使用，并创建必要的备份清单。您必须在第一次创建备份目录之前执行此任务。

  • listbackup 显示与您提供的配置文件关联的现有备份。查看此显示以获取要还原的备份的名称。

  • quick-check 确认所有备份对象均显示在备份清单中，然后输出备份位置中的对象与备份清单中列出的对象之间的差异。

  • quick-repair 根据存储位置和对象构建替换备份清单。

  • remove 移除指定备份或还原点。

  • replicate 将对象从一个群集复制到备用群集。此任务可以与备份和其他复制任务同时运行。

  • restore 还原完整数据库备份或对象级别数据库备份；需要创建备份的配置文件。

参数

‑‑archive timestamp
与 ‑‑task restore 和 ‑‑task remove 命令一起使用，待还原或移除的备份的时间戳：

> vbr ‑‑task restore ‑‑config-file myconfig.ini ‑‑archive=20160115_182640

-c file ‑‑config-file file
用作从中启动 vbr 的位置的绝对或相对路径的配置文件。如果文件不存在，则会发生错误且 vbr 无法继续。
‑‑nodes node[,...]
在其上执行 vbr 任务的节点的逗号分隔列表。列出的节点与配置文件的映射部分中的名称匹配。
‑‑debug level
vbr 提供的调试消息的级别（从 0 到 3）。级别 3 表示详细，而级别 0 为默认值，表示没有消息。
‑‑report-file path/filename
（可选）输出已分隔的 JSON 文件，它描述了关联的完整备份的完整性检查或垃圾回收任务的结果。
‑‑restore-objects objects
从完整备份或对象级别备份还原的单个对象。如果您使用通配符，请改为使用“‑‑include-objects”和 ‑‑exclude-objects。
‑‑s3-force-init
与 ‑‑task init 命令一起使用，当标识/锁定文件不匹配时，强制 init 任务在 S3 存储目标上成功运行。
‑‑showconfig
用于执行任务的配置值，在 vbr 开始之前以原始 JSON 格式显示。
‑‑list-all
与 ‑‑task listbackup 命令一起使用，显示指定配置文件中列出的主机和路径上存储的所有备份的列表。
‑‑json
与 ‑‑task listbackup 命令一起使用，显示指定配置文件中列出的主机和路径上存储的所有备份的 JSON 分隔列表。
‑‑list-output-file path/filename
与 ‑‑task listbackup 命令一起使用，输出一个文件，其中包含指定配置文件中列出的主机和路径上存储的所有备份的 JSON 分隔列表。
‑‑dry-run
与 ‑‑task 命令一起使用，用于备份、还原和复制任务，且对指定的命令进行测试运行，而不实际执行该任务。您可以使用此命令来评估特定 vbr 命令的影响，而不实际执行该命令。例如，您可以查看潜在备份的大小，或该备份中包含的对象。使用 dry-run 参数执行的任何任务均不会影响您的数据库。
‑‑include-objects include-list
指定以逗号分隔的数据库对象或 对象模式的列表，以便从完整备份或对象级别备份中还原。

不能将 ‑‑restore-objects 参数与此参数一起使用。

‑‑exclude-objects exclude-list
数据库对象或 对象模式 与“‑‑include-objects”一起使用时，可从完整备份或对象级别备份中还原，而与参数“--restore-objects”结合使用则无效。

您可以使用 ‑‑include-objects 指定一组对象，然后使用 ‑‑exclude-objects 从该集合中移除对象。使用逗号分隔多个对象和通配符模式。

不能将 ‑‑restore-objects 参数与此参数一起使用。

‑‑restore‑objects='restore‑list'
这是表和架构的逗号分隔列表，可从给定备份中还原，但与参数 ‑‑include-objects 和 ‑‑exclude-objects 结合使用时则无效。

有关用法详细信息，请参阅还原单个对象。

中断 vbr

要取消备份，请使用 Ctrl+C 或向运行 vbr 的 Python 进程发送 SIGINT。 vbr 在复制完数据后停止备份进程。使用 Ctrl+C 取消 vbr 备份时，将立即关闭会话。

中断的备份进程生成的文件仍在目标备份位置目录中。下一个备份进程会从中断的进程停止的位置开始。

备份操作是原子的，因此中断备份操作不会影响上一个备份。Vertica 仅将上一个备份替换为备份数据库的最后一个步骤。

restore 或 copycluster 操作会覆盖数据库编录目录。中断其中任一进程会使数据库不可用，直至您重新启动该进程并允许其完成。

另请参阅