CONFIGURATION PARAMETER预置选项

wal_segment_size

显示预写日志段文件大小。

Shows the size of write ahead log segments.

整数内部引入 9.0（基线）现存至 20 devel 1 次默认值变更

类型: 整数integer
上下文: 内部由编译或 initdb 决定，运行时不能修改
默认值: 16 MiB原始值 16777216 B
取值范围: 1048576 – 1073741824
分类: 预置选项
引入版本: 9.0（基线）
状态: 现存

PostgreSQL 18 手册官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

16 MiB (2048 × 8kB) 9.0 – 10 16 MiB 11 – 20

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

手册说明

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

报告 WAL 段文件的大小。默认是 16MB。详见Section 28.5。

机制详解

显示预写日志段文件大小。它是只读状态，不能通过 SET 或修改配置文件来改变。

它报告 WAL 段大小。PostgreSQL 11 及以后在 initdb 时选择该值；更早集群通常使用构建时数值。

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

调优建议

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

OLTP在线事务处理

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

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

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

常见问题

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

演化历史

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

PostgreSQL 20 ← 19 沿用 19

事实沿用 19
PostgreSQL 11 ← 10 默认值变更

默认值 16 MiB (2048 × 8kB) 16 MiB 单位 8kB B 最小值 2048 1048576 最大值 2048 1073741824 简述 Shows the number of pages per write ahead log segment. Shows the size of write ahead log segments.

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
9.0	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
9.1	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
9.2	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
9.3	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
9.4	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
9.5	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
9.6	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
10	`16 MiB (2048 × 8kB)`	`8kB`	`内部`	`整数`	`2048`	`2048`	`—`
11	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
12	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
13	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
14	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
15	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
16	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
17	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
18	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
19	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`
20 沿用	`16 MiB`	`B`	`内部`	`整数`	`1048576`	`1073741824`	`—`

参考资料

同类参数

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

快速链接