[misc]

本部分收集了一些基本设置，其中包括备份的名称和位置。本部分还会指出您是否正在保留多个备份文件（通过 restorePointLimit 参数指定）。

passwordFile
指定密码配置文件的路径名称。

如果 dbUseLocalConnection 设置为 true，则会忽略此参数。

restorePointLimit
与最近备份一起保留的早期备份的数量。如果设置为 1（默认值），则 Vertica 会保留两个备份：最近备份和之前的备份。

默认值： 1

snapshotName
vbr 为每个节点创建的目录树结构中使用的备份基本名称，最多包含 240 个字符，且仅限以下字符：

  • a–z

  • A–Z

  • 0-9

  • 连字符 (-)

  • 下划线 (_)

此系列中的每次迭代（直到 restorePointLimit）均包含 snapshotName 和备份时间戳。每个系列的备份均应有描述性的唯一快照名称。完整备份和对象级别备份不能共享名称。对于大多数 vbr 任务，snapshotName 在诊断和系统表中充当有用的标识符。对于对象还原和复制任务，snapshotName 用于在共存模式操作中构建架构名称。

默认值： snapshotName

tempDir
指定群集节点上某个临时存储区域的绝对路径。tmp 路径在所有数据库群集节点上必须相同。当 vbr 将文件从源群集节点复制到目标备份位置时，它会将此目录用作日志文件、锁定文件和其他簿记信息的临时存储。此外，vbr 还会将备份日志写入此位置。

位于此位置的文件系统必须支持 fcntl lockf (POSIX) 文件锁定。

默认值： /tmp/vbr

drop_foreign_constraints
布尔值。如果设置为 true，则所有外键约束均会在对象级别还原期间无条件删除。然后，您可以仅还原数据库对象，而不还原其外键依赖项。

默认值：false

enableFreeSpaceCheck
布尔值。如果设置为 true（默认）或“忽略 (omitted)”，则 vbr 会确认指定的备份位置是否具有足够的可用空间以允许成功备份。如果备份位置资源不足，则 vbr 会显示错误消息并取消备份。如果 vbr 无法确定备份目录中的可用空间量或节点数，则会显示警告并继续备份。

默认值： true

excludeObjects
识别要从 includeObjects 指定的集合中排除的数据库对象和通配符模式。Unicode 字符区分大小写；其他则不区分。

此参数仅可与 includeObjects 一起使用。

hadoop_conf_dir
（仅限 HDFS 中的 Eon 模式）高可用性 (HA) 节点。该目录路径包含从 Hadoop 中复制的 XML 配置文件。

如果 vbr 操作包括多个 HA HDFS 群集，请使用以冒号分隔的列表，提供每个 HA HDFS 群集 XML 配置文件的目录路径。例如：

hadoop_conf_dir = path/to/xml-config-hahdfs1:path/to/xml-config-hahdfs2

此值必须与安装期间创建的引导文件中设置的 HadoopConfDir 值匹配。

includeObjects
识别备份任务要包括的数据库对象和通配符模式。您可以将此参数与 excludeObjects 一起使用。Unicode 字符区分大小写；其他则不区分。
kerberos_keytab_file
（仅限 HDFS 中的 Eon 模式）keytab 文件的位置，其中包含 Vertica Kerberos 主体的凭据。

此值必须与安装期间创建的引导文件中设置的 KerberosKeytabFile 值匹配。

kerberos_realm
（仅限 HDFS 中的 Eon 模式）Vertica Kerberos 主体的领域部分。

此值必须与安装期间创建的引导文件中设置的 KerberosRealm 值匹配。

kerberos_service_name
（仅限 HDFS 中的 Eon 模式）Vertica Kerberos 主体的服务名称部分。

此值必须与安装期间创建的引导文件中设置的 KerberosServiceName 值匹配。

默认值： vertica

objectRestoreMode
指定在还原架构或表备份时 vbr 如何处理具有相同名称的对象，可以是以下操作之一：

  • createOrReplace：vbr 创建任何不存在的对象。如果对象已存在，vbr 会使用存档中的版本覆盖该对象。

  • create：vbr 创建任何不存在的对象且不替换现有对象。如果正在还原的对象确实存在，则还原失败。

  • coexist：vbr 创建每个对象的还原版本，其名称格式如下：

    backup_timestamp_objectname

    此方法允许现有对象和还原对象同时存在。如果附加的信息导致架构名称超过最大长度 128 个字符，则 Vertica 会截断该名称。可通过查询系统表 TRUNCATED_SCHEMATA 对原始架构名称执行反向查找。

在所有模式下，vbr 会还原当前时期的数据。对象还原模式设置不会应用于备份和完整还原。

默认值： createOrReplace

objects
对于对象级别备份或对象复制，指定要包含的对象（架构或表）名称。要指定多个对象，请以逗号分隔的列表形式输入多个名称。如果您未指定任何对象，则 vbr 将创建一个完整备份。

您可以按如下方式指定对象：

  • 以 schema.objectname 形式指定表名称。例如，要从架构“finance”创建表“customers”的备份，请输入： finance.customers

    如果公共表和架构具有相同的名称，则 vbr 仅备份架构。请使用 schema.objectname 约定，以避免混淆。

  • 对象名称可包括 UTF-8 字母数字字符。对象名称不能包括转义字符、单引号 (') 或双引号 (") 字符。

  • 使用反斜线 () 后跟一个十六进制值指定非字母数字字符。例如，如果表名称为 my table（my 后跟一个空格字符和 table），请按以下方式输入对象名称：

    objects=my\20table

  • 如果对象名称包含句点，请用双引号将名称括起来。