CONFIGURATION PARAMETER预置选项
huge_pages_status
显示大页的使用状态。
Indicates the status of huge pages.
枚举 内部 引入 17 现存至 20 devel 0 次默认值变更
版本轨迹
相对 PostgreSQL 17 无变化。
默认值变迁
默认值自 PostgreSQL 17 起没有变过。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。
手册说明
报告当前实例中大页的状态：on、off 或 unknown（当通过postgres -C查看时）。 这个参数有助于确定在huge_pages=try时分配大页是否成功。 更多信息参见huge_pages。
机制详解
报告主共享内存区是否实际使用显式大页。它是 internal、只读的启动结果，取值为 off、on 或 unknown。
PostgreSQL 应用 huge_pages 后，根据操作系统支持与可用大页池尝试启动分配，再得出该状态；它不由 PostgreSQL 二进制或 initdb 固定。
用 shared_memory_size_in_huge_pages 估算所需池，并在每次重启后把 huge_pages_status 与请求的 huge_pages 策略对照。Transparent Huge Pages 是另一套操作系统机制。
调优建议
按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。
-
OLTP在线事务处理
不能直接调该状态。请求 on 却显示 off 时，检查 huge_pages 策略、OS 支持、池大小、权限与启动日志；调整 OS 池后重启。
-
OLAP分析与批处理
大型共享内存可能需要大量大页；按真实 shared_memory_size 预留余量，并在每个节点验证 NUMA 放置与重启行为。
-
小规格低配实例与开发机
平台策略无特殊要求时保持 huge_pages=try。不要只为让小共享内存显示 on 就预留过大的 OS 大页池。
常见问题
- 尝试 SET 一个只读启动结果。
- 混淆 huge_pages_status 与配置请求 huge_pages。
- 忽略操作系统大页池过小或启动分配失败。
- 混淆 PostgreSQL 显式大页与 Transparent Huge Pages。
- 误以为一个节点的状态适用于 OS 配置不同的故障切换节点。
演化历史
相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。
-
PostgreSQL 20 ← 19 沿用 19
事实沿用 19
-
PostgreSQL 17 ← 16 新增此参数
PostgreSQL 17 起可用
逐版本快照
每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。
参考资料
同类参数
| 参数 | 类型 | 上下文 | 默认值 | 版本变动 | 最近变更 |
|---|---|---|---|---|---|
block_size |
整数 | 内部 | 8192 |
— | |
| 显示磁盘页块大小。 | 现存 | ||||
data_checksums |
布尔 | 内部 | off |
191 次 | |
| 显示该集群是否启用了数据校验和。 | 现存 | ||||
data_directory_mode |
整数 | 内部 | 448 |
— | |
| 显示数据目录的权限模式。 | 现存 | ||||
debug_assertions |
布尔 | 内部 | off |
9.51 次 | |
| 显示运行中的服务器是否启用了断言检查。 | 现存 | ||||
debug_exec_backend |
布尔 | 内部 | off |
— | |
| 显示运行中的服务器是否启用了 EXEC_BACKEND 构建选项。 | 现存 | ||||
effective_wal_level |
枚举 | 内部 | replica |
— | |
| 显示系统当前实际生效的 WAL 级别。 | 现存 | ||||
huge_pages_status |
枚举 | 内部 | unknown |
— | |
| 显示大页的使用状态。 | 现存 | ||||
in_hot_standby |
布尔 | 内部 | off |
— | |
| 显示当前是否处于 hot standby 状态。 | 现存 | ||||
integer_datetimes |
布尔 | 内部 | on |
— | |
| 显示日期时间是否采用整数表示。 | 现存 | ||||
lc_collate |
字符串 | 内部 | C |
— | |
| 显示排序规则所使用的区域设置。 | 于 16 移除 | ||||
lc_ctype |
字符串 | 内部 | C |
— | |
| 显示字符分类与大小写转换所使用的区域设置。 | 于 16 移除 | ||||
max_function_args |
整数 | 内部 | 100 |
— | |
| 显示函数参数数量上限。 | 现存 | ||||
max_identifier_length |
整数 | 内部 | 63 |
— | |
| 显示标识符长度上限。 | 现存 | ||||
max_index_keys |
整数 | 内部 | 32 |
— | |
| 显示索引键数量上限。 | 现存 | ||||
num_os_semaphores |
整数 | 内部 | 0 |
— | |
| 显示服务器所需的操作系统信号量数量。 | 现存 | ||||
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 |
— | |
| 显示服务器主共享内存区的大小（向上取整到 MB）。 | 现存 | ||||
shared_memory_size_in_huge_pages |
整数 | 内部 | -1 |
— | |
| 显示主共享内存区所需的大页数量。 | 现存 | ||||
ssl_library |
字符串 | 内部 | OpenSSL |
— | |
| 显示 SSL 库的名称。 | 现存 | ||||
wal_block_size |
整数 | 内部 | 8192 |
— | |
| 显示预写日志块大小。 | 现存 | ||||
wal_segment_size |
整数 | 内部 | 16 MiB |
111 次 | |
| 显示预写日志段文件大小。 | 现存 | ||||