pg_checksums
pg_checksums — 在 PostgreSQL 数据库集簇中启用、禁用或检查数据校验和
大纲
pg_checksums [option...] [[ -D | --pgdata ]datadir]
描述
pg_checksums 用于在 PostgreSQL 数据库集簇中检查、启用或禁用数据校验和。运行 pg_checksums 之前，必须先将服务器干净关闭。验证校验和时，如果没有校验和错误，则退出状态为零；如果检测到至少一个校验和失败，则退出状态为非零。启用或禁用校验和时，如果操作失败，则退出状态为非零。
在验证校验和时，集簇中的每个文件都会被扫描。启用校验和时，集簇中的每个文件都会被原地重写。禁用校验和只会更新文件 pg_control。
选项
可以使用以下命令行选项：
-Ddirectory--pgdata=directory指定存储数据库集簇的目录。
-c--check检查校验和。如果没有指定其他模式，这是默认模式。
-d--disable禁用校验和。
-e--enable启用校验和。
-ffilenode--filenode=filenode仅验证文件节点为
filenode的关系中的校验和。-N--no-sync默认情况下，
pg_checksums会等待所有文件被安全写入磁盘。该选项会使pg_checksums直接返回而不等待，这样速度更快，但也意味着如果随后操作系统崩溃，更新后的数据目录可能会损坏。通常，此选项适合测试，但不应在生产环境中使用。使用--check时，此选项不起作用。-P--progress启用进度报告。启用此选项后，在检查或启用校验和时会输出进度报告。
-v--verbose启用详细输出，列出所有被检查的文件。
-V--version打印 pg_checksums 版本并退出。
-?--help显示关于 pg_checksums 命令行参数的帮助并退出。
环境
PGDATA指定存储数据库集簇的目录；可以用
-D选项覆盖。PG_COLOR指定诊断消息是否使用颜色。可选值为
always、auto和never。
注解
在大型集簇中启用校验和可能需要很长时间。在此操作期间，不得启动该集簇，也不得启动任何会向数据目录写入内容的其他程序，否则可能发生数据丢失。
在复制环境中，如果配合会直接复制关系文件块的工具（例如 pg_rewind）使用，而又没有在所有节点上一致地执行启用或禁用校验和的操作，就可能造成表现为校验和不正确的页面损坏。因此，在复制环境中切换校验和时，建议先停止所有集簇，再一致地切换所有节点。另一种安全做法是销毁所有备库，在主库上执行该操作，最后从头重建各备库。
如果在启用或禁用校验和期间 pg_checksums 被中止或杀掉，那么集簇的数据校验和配置将保持不变，并且可以重新运行 pg_checksums 以执行同一操作。