目录

client_encoding

用于设置客户端编码的 GUC

client_encoding 是一个用于设置客户端编码（字符集）的 配置参数。

client_encoding 在 PostgreSQL 6.4 中被添加。

用法

client_encoding 可用于设置或检索当前的客户端编码。

检索客户端编码的其他方法

按 PostgreSQL 版本详细信息

client_encoding (PostgreSQL 19)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 18)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 17)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 16)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 15)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 14)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 13)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 12)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 11)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 10)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 9.6)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 9.5)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  
需要重启 false

文档：client_encoding

client_encoding (PostgreSQL 9.4)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  

文档：client_encoding

client_encoding (PostgreSQL 9.3)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  

文档：client_encoding

client_encoding (PostgreSQL 9.2)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  

文档：client_encoding

client_encoding (PostgreSQL 9.1)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  

文档：client_encoding

client_encoding (PostgreSQL 9.0)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  

文档：client_encoding

client_encoding (PostgreSQL 8.4)

设置 SQL_ASCII
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  
枚举值  
启动值 SQL_ASCII
重置值 SQL_ASCII
源文件  
源行  

文档：client_encoding

client_encoding (PostgreSQL 8.3)

设置  
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  

文档：client_encoding

client_encoding (PostgreSQL 8.2)

设置  
单位  
类别 客户端连接默认值 / 区域设置和格式
简短描述 设置客户端的字符集编码。
扩展描述  
上下文 user
变量类型 string
来源 默认
最小值  
最大值  

文档：client_encoding

变更历史

示例

client_encoding 的基本用法示例

postgres=# SHOW client_encoding;
 client_encoding 
-----------------
 UTF8
(1 row)

尝试设置无效的编码

postgres=# SET client_encoding = 'klingon';
ERROR:  invalid value for parameter "client_encoding": "klingon"

分类

GUC 配置项, 区域设置和字符集处理

另请参阅

pg_client_encoding(), server_encoding

反馈

提交有关“client_encoding”的任何评论、建议或更正，请在此处 提交。