PostgreSQL自带的命令行工具19- pg

PostgreSQL自带的命令行工具19- pg_checksums

基础信息
OS版本：Red Hat Enterprise Linux Server release 7.9 (Maipo)
DB版本：16.2
pg软件目录：/home/pg16/soft
pg数据目录：/home/pg16/data
端口：5777

pg_checksums 是 PostgreSQL 数据库中的一个工具，用于启用、禁用或校验数据页。数据页校验是 PostgreSQL 9.3 版本引入的一项功能，旨在提高数据完整性，通过对每个数据页计算校验，并在数据读取时验证这些校验，来检测硬件故障或磁盘I/O错误导致的数据损坏。

通过help查看帮助文档。

pg_checksums --help
pg_checksums enables, disables, or verifies data checksums in a PostgreSQL database cluster.Usage:pg_checksums [OPTION]... [DATADIR]Options:[-D, --pgdata=]DATADIR    data directory-c, --check              check data checksums (default)-d, --disable            disable data checksums-e, --enable             enable data checksums-f, --filenode=FILENODE  check only relation with specified filenode-N, --no-sync            do not wait for changes to be written safely to disk-P, --progress           show progress information-v, --verbose            output verbose messages-V, --version            output version information, then exit-?, --help               show this help, then exitIf no data directory (DATADIR) is specified, the environment variable PGDATA
is used.Report bugs to <pgsql-bugs@lists.postgresql.org>.
PostgreSQL home page: <https://www.postgresql.org/>

主要功能

启用校验： 在初始化数据库集群时 (initdb 使用 -k 或 --data-checksums 选项) 可以启用页面校验。如果你的数据库是在没有启用校验的情况下初始化的，你可以使用 pg_checksums 工具来启用它们，但这需要在数据库服务器关闭的情况下进行。
禁用校验： 与启用校验相同，禁用校验也需要在数据库服务器关闭的情况下进行。
校验数据库文件： pg_checksums 只能在数据库关闭时进行，用于校验所有数据文件的校验，来检测潜在的数据损坏。

使用 `pg_checksums`

1 停止数据库服务

在启用或禁用校验和时，确保首先停止 PostgreSQL 服务：

[pg16@test ~]$ pg_ctl stop
waiting for server to shut down....2024-05-10 06:13:43.605 PDT [88551] DEBUG:  logger shutting downdone
server stopped

2 启用校验

在 PostgreSQL 数据目录上运行 pg_checksums 来启用校验。我的库在初始化时已经加-K 参数，故提示已enabled。

[pg16@test 16413]$ pg_checksums --enable -D /home/pg16/data/
pg_checksums: error: data checksums are already enabled in cluster

3 禁用校验

pg_checksums --disable -D /home/pg16/data/

4 校验

[pg16@test 16413]$ pg_checksums -D /home/pg16/data/
Checksum operation completed
Files scanned:   1862
Blocks scanned:  26646
Bad checksums:  0
Data checksum version: 1

数据库运行时执行校验的话会报错。

[pg16@test ~]$ pg_checksums -D /home/pg16/data/
pg_checksums: error: cluster must be shut down

这将会报告任何发现的校验和错误，但不会修复它们。

5 重启数据库服务

在启用或禁用校验和后，需要重启 PostgreSQL 服务

[pg16@test ~]$ pg_ctl start
waiting for server to start....2024-05-10 06:36:32.829 PDT [90005] DEBUG:  registering background worker "logical replication launcher"
2024-05-10 06:36:32.829 PDT [90005] DEBUG:  loaded library "pg_stat_statements"
2024-05-10 06:36:32.829 PDT [90005] DEBUG:  mmap(153092096) with MAP_HUGETLB failed, huge pages disabled: Cannot allocate memory
2024-05-10 06:36:32.838 PDT [90005] LOG:  redirecting log output to logging collector process
2024-05-10 06:36:32.838 PDT [90005] HINT:  Future log output will appear in directory "log".done
server started