CONFIGURATION PARAMETER预置选项

server_encoding

报告数据库的编码（字符集）。

Shows the server (database) character set encoding.

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

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

PostgreSQL 18.7 手册官方文档

版本轨迹

相对 PostgreSQL 17 无变化。

默认值变迁

SQL_ASCII 9.0 – 19

已记录的默认值在 PostgreSQL 9.0–19 之间未变。带单位的取值换算成了可读形式，原始的 boot_val 与单位写在悬浮提示里。

手册说明

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

报告数据库的编码（字符集）。这是在数据库被创建时决定的。通常，客户端只需要关心 client_encoding 的值。

机制详解

显示服务器（数据库）字符集编码。它是只读状态，不能通过 SET 或修改配置文件来改变。

它报告当前数据库编码；编码在建库时选定，同一集群的不同数据库可以不同。

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

调优建议

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

OLTP在线事务处理

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

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

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

常见问题

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

演化历史

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

PostgreSQL 14 ← 13 仅描述更新

简述 Sets the server (database) character set encoding. Shows the server (database) character set encoding.
PostgreSQL 8.0 ← 7.4 新增此参数

PostgreSQL 8.0 起可用

逐版本快照

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

版本	默认值	单位	上下文	类型	最小值	最大值	枚举值
8.0	—	—	—	`字符串`	—	—	—
8.1	—	—	—	`字符串`	—	—	—
8.2	—	—	—	`字符串`	—	—	—
8.3	—	—	—	`字符串`	—	—	—
8.4	—	—	—	`字符串`	—	—	—
9.0	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.1	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.2	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.3	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.4	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.5	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
9.6	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
10	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
11	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
12	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
13	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
14	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
15	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
16	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
17	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
18	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
19	`SQL_ASCII`	`—`	`内部`	`字符串`	`—`	`—`	`—`
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 段文件的大小。				现存

快速链接