app-pgchecksums.md

## 皮克\_校验和

皮克\_checksums — 在 PostgreSQL 数据库集群中启用、禁用或检查数据校验和

## 概要

`pg_checksums` [*`选项`*...][ `-D`pgdata| `--]*`数据目录`*]

## 描述

皮克\_checksums 检查、启用或禁用 PostgreSQL 集群中的数据校验和。在运行 pg 之前必须彻底关闭服务器\_校验和。验证校验和时，如果没有校验和错误，则退出状态为零，如果检测到至少一个校验和失败，则退出状态为非零。启用或禁用校验和时，如果操作失败，则退出状态为非零。

验证校验和时，会扫描集群中的每个文件。启用校验和时，集群中的每个文件都被原地重写。禁用校验和仅更新文件`pg_control`.

## 选项

以下命令行选项可用：

`-D *`目录`*`\
`--pgdata=*`目录`*`

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

`-c`\
`- 查看`

检查校验和。如果未指定其他内容，这是默认模式。

`-d`\
`--禁用`

禁用校验和。

`-e`\
`- 使能够`

启用校验和。

`-f *`文件节点`*`\
`--文件节点=*`文件节点`*`

仅验证与 filenode 关系中的校验和*`文件节点`*.

`-N`\
`--不同步`

默认，`pg_checksums`将等待所有文件安全地写入磁盘。此选项导致`pg_checksums`无需等待即可返回，这样更快，但意味着后续的操作系统崩溃可能会使更新的数据目录损坏。通常，此选项对测试很有用，但不应在生产安装中使用。使用时此选项无效`- 查看`.

`-P`\
`- 进步`

启用进度报告。打开此选项将在检查或启用校验和时提供进度报告。

`-v`\
`--详细`

启用详细输出。列出所有检查的文件。

`-V`\
`- 版本`

打印 pg\_校验和版本并退出。

`-？`\
`- 帮助`

显示关于 pg 的帮助\_校验和命令行参数，然后退出。

## 环境

`PGD​​ATA`

指定存储数据库集群的目录；可以使用`-D`选项。

`PG_COLOR`

指定是否在诊断消息中使用颜色。可能的值为`总是`,`汽车`和`绝不`.

## 笔记

在大型集群中启用校验和可能需要很长时间。在此操作过程中，不能启动集群或其他写入数据目录的程序，否则可能会导致数据丢失。

将复制设置与执行关系文件块的直接副本的工具一起使用时（例如[皮克\_倒带](app-pgrewind.html))，如果在所有节点上没有一致地执行操作，启用或禁用校验和可能会导致不正确校验和形式的页面损坏。在复制设置中启用或禁用校验和时，建议停止所有集群，然后再一致地切换它们。销毁所有备用数据库，在主数据库上执行操作并最终从头开始重新创建备用数据库也是安全的。

如果 pg\_启用或禁用校验和时校验和被中止或终止，集群的数据校验和配置保持不变，并且 pg\_可以重新运行校验和以执行相同的操作。