pg_verifybackup
是一个用于验证使用 pg_basebackup
创建的备份的完整性的核心实用程序,它使用备份清单进行验证。
pg_verifybackup
添加于 PostgreSQL 13。
用法
在最简单的形式中,pg_verifybackup
通过提供包含备份清单文件的数据库目录的路径来执行,它将报告验证成功或包含错误的文件的详细信息。
pg_verifybackup
应该在备份完成后执行,但在服务器启动之前执行。如果服务器已启动,它将报告错误。
可以使用其他选项来控制详细程度、各种文件和目录的位置(备份清单
本身、pg_wal
目录等);有关更多详细信息,请参阅文档和/或 pg_verifybackup --help
的输出。
某些备份后可能进行修改的文件()将从验证中排除,任何使用 -i
/--ignore
选项指定的文件/路径也将被排除。
请注意,与许多其他实用程序不同,pg_verifybackup
不会选择性地接受 -D
/--pgdata
选项来指定数据目录;此不一致性的原因可以在这里找到。
更改历史记录
- PostgreSQL 16
- 添加了选项
-P
/--progress
(d07c2948)
- 添加了选项
- PostgreSQL 13
- 添加(初始提交 0d8c9c12,最初为
pg_validatebackup
)
- 添加(初始提交 0d8c9c12,最初为
示例
pg_verifybackup
的基本用法示例
$ pg_basebackup -l "base backup" -D /path/to/data -h node1 -U repuser -c fast -X stream --no-slot --verbose pg_basebackup: initiating base backup, waiting for checkpoint to complete pg_basebackup: checkpoint completed pg_basebackup: write-ahead log start point: 0/4000028 on timeline 1 pg_basebackup: starting background WAL receiver pg_basebackup: write-ahead log end point: 0/4000100 pg_basebackup: waiting for background process to finish streaming ... pg_basebackup: syncing data to disk ... pg_basebackup: renaming backup_manifest.tmp to backup_manifest pg_basebackup: base backup completed $ pg_verifybackup /path/to/data backup successfully verified
参考
- PostgreSQL 文档: pg_verifybackup
另请参阅
备份清单,pg_basebackup