选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

pg_checksums

pg_checksums — 在PostgreSQL数据库集簇中启用、禁用或检查数据校验和

Synopsis

pg_checksums [option...] [[ -D | --pgdata ]datadir]

描述

pg_checksums用于在PostgreSQL数据库集簇中检查、启用或禁用数据校验和。运行pg_checksums之前,必须先将服务器干净关闭。验证校验和时,如果没有校验和错误,则退出状态为零;如果检测到至少一个校验和失败,则退出状态为非零。启用或禁用校验和时,如果操作失败,则退出状态为非零。

在验证校验和时,集簇中的每个文件都会被扫描。启用校验和时,校验和发生变化的每个关系文件块都会被原地重写。 禁用校验和只会更新文件pg_control

选项

可以使用以下命令行选项:

-D directory
--pgdata=directory

指定存储数据库集簇的目录。

-c
--check

检查校验和。如果没有指定其他模式,这是默认模式。

-d
--disable

禁用校验和。

-e
--enable

启用校验和。

-f filenode
--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

指定是否在诊断消息中使用颜色。可能的值为alwaysautonever

注解

在大型集簇中启用校验和可能需要很长时间。在此操作期间,不得启动该集簇,也不得启动任何会向数据目录写入内容的其他程序,否则可能发生数据丢失。

在复制环境中,如果配合会直接复制关系文件块的工具(例如pg_rewind)使用,而又没有在所有节点上一致地执行启用或禁用校验和的操作,就可能因校验和不正确而导致页面损坏。因此,在复制环境中切换校验和时,建议先停止所有集簇,再一致地切换所有节点。另一种安全做法是销毁所有备库,在主库上执行该操作,最后从头重建各备库。

如果在启用或禁用校验和期间pg_checksums被中止或杀掉,那么集簇的数据校验和配置将保持不变,并且可以重新运行pg_checksums以执行同一操作。