CONFIGURATION PARAMETER预置选项

server_version

报告服务器的版本号。

Shows the server version.

字符串内部引入 8.0 现存至 20 devel 16 次默认值变更

类型: 字符串string
上下文: 内部由编译或 initdb 决定，运行时不能修改
默认值: 18.6 (Debian 18.6-1.pgdg13+2)
分类: 预置选项
引入版本: 8.0
状态: 现存

PostgreSQL 18.7 手册官方文档

版本轨迹

相对 PostgreSQL 17：默认值由 17.11 (Debian 17.11-1.pgdg13+2) 改为 18.6 (Debian 18.6-1.pgdg13+2)。

默认值变迁

9.0.23 9.0 9.1.24 9.1 9.2.23 9.2 9.3.25 9.3 9.4.26 9.4 9.5.25 9.5 9.6.24 9.6 10.23 (Debian 10.23-1.pgdg110+1) 10 11.22 (Debian 11.22-1.pgdg120+1) 11 12.22 (Debian 12.22-1.pgdg120+1) 12 13.23 (Debian 13.23-1.pgdg13+1) 13 14.24 (Debian 14.24-1.pgdg13+2) 14 15.19 (Debian 15.19-1.pgdg13+2) 15 16.15 (Debian 16.15-1.pgdg13+2) 16 17.11 (Debian 17.11-1.pgdg13+2) 17 18.6 (Debian 18.6-1.pgdg13+2) 18 19beta4 (Debian 19~beta4-1.pgdg13+1) 19

默认值一共换过 17 档，每段的宽度按它覆盖的大版本数伸展，深色的一段是当前查看的 PostgreSQL 18.7。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

PostgreSQL 18.7 手册 · 19.15 预置选项本站手册官方原文

报告服务器的版本号。它是由编译服务器时的 PG_VERSION 值决定的。

机制详解

显示服务器版本。它是只读状态，不能通过 SET 或修改配置文件来改变。

它是人类可读的服务器构建/版本字符串，可能包含发行商文字，不适合做数值排序。

联动解读应同时查看 server_version_num、server_encoding、ssl_library。应用与运维工具可读取 server_version 做能力或环境判断，但不能依靠 SET 改变它；跨集群比较时还要考虑构建、initdb 与当前数据库差异。

调优建议

按典型负载给出的取值思路，不是放之四海皆准的配方：实际取值要看数据量、并发度与硬件。

OLTP在线事务处理

不可调。把 server_version 当作部署与能力事实记录；若与预期不符，应修正二进制、initdb 或数据库创建流程，而不是 SET。
OLAP分析与批处理

不可调。用 server_version 校验分析节点的格式、构建或资源假设，并确保所有读写节点兼容。
小规格低配实例与开发机

不可调。只需在清单与故障报告中保留该值；不要为改变它而做不必要的自定义构建或重建。

常见问题

尝试用 SET 或配置文件改变只读的 server_version。
假定所有集群、数据库或发行包的报告值相同。
在文件格式或功能兼容性检查中忽略该值。
把显示值当作性能目标，而不是环境事实。

演化历史

相邻两个大版本之间的差异，新的在前。版本号链到该版的快照。

PostgreSQL 19 ← 18 默认值变更

默认值 18.6 (Debian 18.6-1.pgdg13+2) 19beta4 (Debian 19~beta4-1.pgdg13+1)
PostgreSQL 18 ← 17 默认值变更

默认值 17.11 (Debian 17.11-1.pgdg13+2) 18.6 (Debian 18.6-1.pgdg13+2)
PostgreSQL 17 ← 16 默认值变更

默认值 16.15 (Debian 16.15-1.pgdg13+2) 17.11 (Debian 17.11-1.pgdg13+2)
PostgreSQL 16 ← 15 默认值变更

默认值 15.19 (Debian 15.19-1.pgdg13+2) 16.15 (Debian 16.15-1.pgdg13+2)
PostgreSQL 15 ← 14 默认值变更

默认值 14.24 (Debian 14.24-1.pgdg13+2) 15.19 (Debian 15.19-1.pgdg13+2)
PostgreSQL 14 ← 13 默认值变更

默认值 13.23 (Debian 13.23-1.pgdg13+1) 14.24 (Debian 14.24-1.pgdg13+2)
PostgreSQL 13 ← 12 默认值变更

默认值 12.22 (Debian 12.22-1.pgdg120+1) 13.23 (Debian 13.23-1.pgdg13+1)
PostgreSQL 12 ← 11 默认值变更

默认值 11.22 (Debian 11.22-1.pgdg120+1) 12.22 (Debian 12.22-1.pgdg120+1)
PostgreSQL 11 ← 10 默认值变更

默认值 10.23 (Debian 10.23-1.pgdg110+1) 11.22 (Debian 11.22-1.pgdg120+1)
PostgreSQL 10 ← 9.6 默认值变更

默认值 9.6.24 10.23 (Debian 10.23-1.pgdg110+1)
PostgreSQL 9.6 ← 9.5 默认值变更

默认值 9.5.25 9.6.24
PostgreSQL 9.5 ← 9.4 默认值变更

默认值 9.4.26 9.5.25
PostgreSQL 9.4 ← 9.3 默认值变更

默认值 9.3.25 9.4.26
PostgreSQL 9.3 ← 9.2 默认值变更

默认值 9.2.23 9.3.25
PostgreSQL 9.2 ← 9.1 默认值变更

默认值 9.1.24 9.2.23
PostgreSQL 9.1 ← 9.0 默认值变更

默认值 9.0.23 9.1.24
PostgreSQL 8.0 ← 7.4 新增此参数

PostgreSQL 8.0 起可用

逐版本快照

每个收录版本里的 7 项事实，与上一个存在的版本不同的格子带底色。版本号链到该版。

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
8.0	—	—	—	`字符串`	—	—	—
8.1	—	—	—	`字符串`	—	—	—
8.2	—	—	—	`字符串`	—	—	—
8.3	—	—	—	`字符串`	—	—	—
8.4	—	—	—	`字符串`	—	—	—
9.0	`9.0.23`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.1	`9.1.24`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.2	`9.2.23`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.3	`9.3.25`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.4	`9.4.26`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.5	`9.5.25`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.6	`9.6.24`	`—`	`内部`	`字符串`	`—`	`—`	`—`
10	`10.23 (Debian 10.23-1.pgdg110+1)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
11	`11.22 (Debian 11.22-1.pgdg120+1)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
12	`12.22 (Debian 12.22-1.pgdg120+1)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
13	`13.23 (Debian 13.23-1.pgdg13+1)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
14	`14.24 (Debian 14.24-1.pgdg13+2)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
15	`15.19 (Debian 15.19-1.pgdg13+2)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
16	`16.15 (Debian 16.15-1.pgdg13+2)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
17	`17.11 (Debian 17.11-1.pgdg13+2)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
18	`18.6 (Debian 18.6-1.pgdg13+2)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
19	`19beta4 (Debian 19~beta4-1.pgdg13+1)`	`—`	`内部`	`字符串`	`—`	`—`	`—`
20	—	—	—	`字符串`	—	—	—

参考资料

同类参数

参数	类型	上下文	默认值	最近变更
Preset Options 预置选项 24 个 ↗
`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 段文件的大小。				现存

快速链接