描述

pg_verifybackup 用于检查通过 pg_basebackup 获取的数据库集簇备份的完整性，检查依据是服务器在备份时生成的 backup_manifest。备份必须以“普通文件”格式存储；“tar”格式的备份可以在解包后检查。

需要注意，pg_verifybackup 执行的验证并未、也不可能涵盖运行中的服务器在尝试使用该备份时会执行的每一项检查。即使使用了此工具，你仍应进行测试恢复，并确认生成的数据库按预期工作且看起来包含正确的数据。不过，pg_verifybackup 能够检测出许多因存储问题或用户错误而常见的问题。

备份验证分为四个阶段。首先，pg_verifybackup 读取 backup_manifest 文件。如果该文件不存在、无法读取、格式不正确、其系统标识符与备份目录中的 pg_control 不匹配，或者未能通过其自身内部校验和的验证，pg_verifybackup 就会以致命错误终止。

其次，pg_verifybackup 将尝试验证当前存储在磁盘上的数据文件与服务器原本打算发送的数据文件完全一致，但下文所述的少数例外情况除外。除了少数例外情况之外，多余文件和缺失文件都会被检测出来。此步骤会忽略 postgresql.auto.conf、standby.signal 和 recovery.signal 的存在或缺失，以及对它们的任何修改，因为预计这些文件可能是在执行备份的过程中创建或修改的。它也不会因目标目录中的 backup_manifest 文件，或 pg_wal 中的任何内容而报告问题，尽管这些文件不会列在备份清单中。这里只检查文件；除间接情况外，不会验证目录是否存在：如果某个目录缺失，则它本应包含的任何文件也必然会缺失。

接着，pg_verifybackup 会为所有文件计算校验和，将其与备份清单中的值进行比较，并对计算结果与备份清单中保存的校验和不匹配的文件报错。对于上一步已产生错误的文件，不会执行这一步，因为这些文件已经确定存在问题。在上一步中被忽略的文件，在这一步中也会被忽略。

最后，pg_verifybackup 会利用备份清单验证从该备份执行恢复所需的预写式日志记录是否存在，并且能够被读取和解析。backup_manifest 包含关于所需预写式日志记录的信息，pg_verifybackup 会利用这些信息调用 pg_waldump 来解析这些预写式日志记录。调用时会使用 --quiet 标志，这样 pg_waldump 只会报告错误，而不会产生其他输出。这个层次的验证足以发现诸如文件缺失或文件内部校验和不匹配之类的明显问题，但还不够全面，无法检测恢复时可能发生的每一种问题。例如，如果服务器中的 bug 生成了校验和正确、但指定的动作毫无意义的预写式日志记录，这种方法就无法检测出来。

另请注意，如果存在恢复该备份并不需要的额外 WAL 文件，此工具不会检查它们；不过，可以为此单独调用一次 pg_waldump。还要注意，WAL 验证与版本相关：你必须使用与被检查备份对应版本的 pg_verifybackup，因此也必须使用对应版本的 pg_waldump。相比之下，数据文件完整性检查应当适用于任何能够生成 backup_manifest 文件的服务器版本。

选项

pg_verifybackup 接受以下命令行参数：

其他选项也可用：

示例

要为位于 mydbserver 的服务器创建基础备份，并验证该备份的完整性：

$ pg_basebackup -h mydbserver -D /usr/local/pgsql/data
$ pg_verifybackup /usr/local/pgsql/data

要为位于 mydbserver 的服务器创建基础备份，将备份清单移到备份目录之外的位置，然后验证该备份：

$ pg_basebackup -h mydbserver -D /usr/local/pgsql/backup1234
$ mv /usr/local/pgsql/backup1234/backup_manifest /my/secure/location/backup_manifest.1234
$ pg_verifybackup -m /my/secure/location/backup_manifest.1234 /usr/local/pgsql/backup1234

要在验证备份时忽略一个手工添加到备份目录中的文件，并同时跳过校验和验证：

$ pg_basebackup -h mydbserver -D /usr/local/pgsql/data
$ edit /usr/local/pgsql/data/note.to.self
$ pg_verifybackup --ignore=note.to.self --skip-checksums /usr/local/pgsql/data

另见