pg_checksums

在离线模式下激活/启用/禁用数据库集群的校验和功能

概览

扩展包名版本分类许可证语言
pg_checksums1.3ADMINBSD 2-ClauseC
ID扩展名BinLibLoadCreateTrustReloc模式
5110pg_checksums-
相关扩展pg_catcheck amcheck pg_surgery pageinspect pg_visibility pgstattuple pg_repack pg_squeeze

版本

类型仓库版本PG 大版本包名依赖
EXTPGDG1.31817161514pg_checksums-
RPMPGDG1.31817161514pg_checksums_$v-
DEBPGDG1.31817161514postgresql-$v-pg-checksums-
OS / PGPG18PG17PG16PG15PG14
el8.x86_64
el8.aarch64
el9.x86_64
el9.aarch64
el10.x86_64
el10.aarch64
d12.x86_64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
d12.aarch64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
d13.x86_64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
d13.aarch64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
u22.x86_64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
u22.aarch64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
u24.x86_64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
u24.aarch64
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3
PGDG 1.3

安装

您可以直接安装 pg_checksums 扩展包的预置二进制包,首先确保 PGDG 仓库已经添加并启用:

pig repo add pgdg -u          # 添加 PGDG 仓库并更新缓存

使用 pig 或者是 apt/yum/dnf 安装扩展:

pig install pg_checksums;          # 当前活跃 PG 版本安装
pig ext install -y pg_checksums -v 18  # PG 18
pig ext install -y pg_checksums -v 17  # PG 17
pig ext install -y pg_checksums -v 16  # PG 16
pig ext install -y pg_checksums -v 15  # PG 15
pig ext install -y pg_checksums -v 14  # PG 14
dnf install -y pg_checksums_18       # PG 18
dnf install -y pg_checksums_17       # PG 17
dnf install -y pg_checksums_16       # PG 16
dnf install -y pg_checksums_15       # PG 15
dnf install -y pg_checksums_14       # PG 14
apt install -y postgresql-18-pg-checksums   # PG 18
apt install -y postgresql-17-pg-checksums   # PG 17
apt install -y postgresql-16-pg-checksums   # PG 16
apt install -y postgresql-15-pg-checksums   # PG 15
apt install -y postgresql-14-pg-checksums   # PG 14

此扩展不需要执行 CREATE EXTENSION 语句

用法

pg_checksums: 在离线 Postgres 集群中激活/停用/验证校验和

pg_checksums_ext 是一个命令行工具(基于 PostgreSQL 内置的 pg_checksums),可以验证、激活或停用 PostgreSQL 集群的页级校验和。它扩展了内置工具,增加了在线验证、SIGUSR1 进度切换、精细进度报告和 I/O 速率限制功能。

验证校验和(可在线执行)

pg_checksums_ext -D /path/to/data --check

启用校验和(需要干净关闭)

pg_checksums_ext -D /path/to/data --enable

禁用校验和(需要干净关闭)

pg_checksums_ext -D /path/to/data --disable

其他选项

  • -D, --pgdata – 数据目录路径
  • --check / --enable / --disable – 操作模式
  • --progress – 显示进度报告
  • --filenode – 仅检查特定 filenode
  • --no-sync – 跳过 fsync
  • --verbose – 详细输出
  • --debug – 调试输出
  • 发送 SIGUSR1 可在操作期间切换进度报告

最后修改 2026-03-14: update extension metadata (953cbd0)