CONFIGURATION PARAMETER预置选项
data_checksums
报告这个集簇的数据校验和状态。
Reports the state of data checksums for this cluster.
布尔 内部 引入 9.3 现存至 20 devel 0 次默认值变更
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
已记录的默认值在 PostgreSQL 9.3–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
报告对这个集簇是否启用了数据校验和。详见 -k。
机制详解
报告控制文件记录的集群级数据校验和状态。它在 SQL 中是 internal/只读值，不能通过 SET 修改。
校验和可由 initdb 选定，也可在服务器停止后通过 pg_checksums 修改。PostgreSQL 从存储读取页时验证校验和，写页时计算校验和。
校验和能发现撕裂或损坏页，但不能修复，也不能证明 WAL、备份、内存与所有存储层都健康。变更需要离线流程、全集群扫描容量和已验证备份。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
把该值视作完整性能力，而非性能旋钮。持久集群优先使用校验和并监控失败；既有集群应通过计划好的离线 pg_checksums 流程变更。
-
OLAP分析与批处理
按真实数据集预算校验和 CPU 与启停所需的全集群扫描；离线转换前验证备份与副本兼容性。
-
小规格低配实例与开发机
尽量在 initdb 时启用。既有小集群通常用 pg_checksums 比重建简单，但仍需停机与可恢复备份。
常见问题
- 尝试通过 SET 或 ALTER SYSTEM 修改只读报告。
- 服务器未干净停机时运行 pg_checksums。
- 误以为忽略校验和错误就能修复损坏。
- 误以为校验和本身能验证 WAL 记录、逻辑正确性或备份。
- 启用后未监控校验和失败与存储健康。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 属性变更
类型
布尔枚举 -
PostgreSQL 9.3 ← 9.2 新增此参数
PostgreSQL 9.3 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
| 版本 | 默认值 | 单位 | 上下文 | 类型 | 最小值 | 最大值 | 枚举值 |
|---|---|---|---|---|---|---|---|
| 9.3 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 9.4 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 9.5 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 9.6 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 10 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 11 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 12 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 13 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 14 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 15 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 16 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 17 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 18 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 19 | off |
— |
内部 |
布尔 |
— |
— |
— |
| 20 | — | — | — | 枚举 |
— | — | — |
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
block_size |
整数 | 内部 | 8192 |
— | |
| 报告一个磁盘块的大小。 | 现存 | ||||
data_checksums |
布尔 | 内部 | off |
201 次 | |
| 报告这个集簇的数据校验和状态。 | 现存 | ||||
data_directory_mode |
整数 | 内部 | 448 |
— | |
| 在 Unix 系统上，这个参数报告服务器启动时数据目录（由 data_directory 定义）的权限。 | 现存 | ||||
debug_assertions |
布尔 | 内部 | off |
9.51 次 | |
| 报告 PostgreSQL 是否在构建时启用了断言。 | 现存 | ||||
debug_exec_backend |
布尔 | — | — | ||
| 报告 PostgreSQL 是否在构建时启用了 EXEC_BACKEND。 | 现存 | ||||
effective_wal_level |
枚举 | — | — | ||
| 报告当前系统中实际生效的 WAL 记录级别。 | 现存 | ||||
huge_pages_status |
枚举 | 内部 | unknown |
— | |
| 报告当前实例中大页的状态：on、off 或 unknown（当通过 postgres -C 查看时）。 | 现存 | ||||
in_hot_standby |
布尔 | 内部 | off |
— | |
| 报告服务器当前是否处于热备模式。 | 现存 | ||||
integer_datetimes |
布尔 | 内部 | on |
— | |
| 报告 PostgreSQL 是否在编译时启用了对 64 位整数日期和时间的支持。 | 现存 | ||||
lc_collate |
字符串 | 内部 | C |
— | |
| 报告对文本数据进行排序所使用的区域设置。 | 于 16 移除 | ||||
lc_ctype |
字符串 | 内部 | C |
— | |
| 报告决定字符分类的区域设置。 | 于 16 移除 | ||||
max_function_args |
整数 | 内部 | 100 |
— | |
| 报告函数参数的最大数量。 | 现存 | ||||
max_identifier_length |
整数 | 内部 | 63 |
— | |
| 报告标识符的最大长度。 | 现存 | ||||
max_index_keys |
整数 | 内部 | 32 |
— | |
| 报告索引键的最大数目。 | 现存 | ||||
num_os_semaphores |
整数 | 内部 | 0 |
— | |
| 根据配置的最大连接数（max_connections）、允许的自动清理工作进程数（autovacuum_max_workers）、允许的 WAL 发送进程数（max_wal_senders）、允许的后台进程数（max_worker_processes）等，报告服务器所需的信号量数量。 | 现存 | ||||
segment_size |
整数 | 内部 | 1 GiB (131072 × 8kB) |
— | |
| 报告一个文件段中可以存储的块（页）的数量。 | 现存 | ||||
server_encoding |
字符串 | 内部 | SQL_ASCII |
— | |
| 报告数据库的编码（字符集）。 | 现存 | ||||
server_version |
字符串 | 内部 | 18.6 (Debian 18.6-1.pgdg13+2) |
1916 次 | |
| 报告服务器的版本号。 | 现存 | ||||
server_version_num |
整数 | 内部 | 180006 |
1916 次 | |
| 以整数形式报告服务器的版本号。 | 现存 | ||||
shared_memory_size |
整数 | 内部 | 0 B |
— | |
| 报告主共享内存区域的大小，向上取整到整数兆字节。 | 现存 | ||||
shared_memory_size_in_huge_pages |
整数 | 内部 | -1 |
— | |
| 报告基于指定的 huge_page_size 所需的主共享内存区域的大页数。 | 现存 | ||||
ssl_library |
字符串 | 内部 | OpenSSL |
— | |
| 报告此 PostgreSQL 服务器在构建时使用的 SSL 库的名称（即使此实例当前未配置或使用 SSL），例如 OpenSSL，如果没有使用 SSL 库，则报告空字符串。 | 现存 | ||||
wal_block_size |
整数 | 内部 | 8192 |
— | |
| 报告一个 WAL 磁盘块的尺寸。 | 现存 | ||||
wal_segment_size |
整数 | 内部 | 16 MiB |
111 次 | |
| 报告 WAL 段文件的大小。 | 现存 | ||||