client_encoding 是一个用于设置客户端编码（字符集）的配置参数。
client_encoding 在PostgreSQL 6.4 中添加。
用法
client_encoding 可用于设置或检索当前客户端编码。
检索客户端编码的替代方法
SELECT pg_client_encoding()SELECT current_setting('client_encoding')
按 PostgreSQL 版本详细说明
client_encoding (PostgreSQL 17)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 16)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 15)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 14)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 13)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 12)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 11)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 10)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 9.6)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 9.5)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 | |
| 挂起重启 | 否 |
文档: client_encoding
client_encoding (PostgreSQL 9.4)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 |
文档: client_encoding
client_encoding (PostgreSQL 9.3)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 |
文档: client_encoding
client_encoding (PostgreSQL 9.2)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 |
文档: client_encoding
client_encoding (PostgreSQL 9.1)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 |
文档: client_encoding
client_encoding (PostgreSQL 9.0)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 |
文档: client_encoding
client_encoding (PostgreSQL 8.4)
| 设置 | SQL_ASCII |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 | |
| 枚举值 | |
| 引导值 | SQL_ASCII |
| 重置值 | SQL_ASCII |
| 源文件 | |
| 源代码行号 |
文档: client_encoding
client_encoding (PostgreSQL 8.3)
| 设置 | |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 |
文档: client_encoding
client_encoding (PostgreSQL 8.2)
| 设置 | |
| 单位 | |
| 类别 | 客户端连接默认值 / 区域设置和格式 |
| 简短描述 | 设置客户端的字符集编码。 |
| 额外描述 | |
| 上下文 | 用户 |
| 变量类型 | 字符串 |
| 来源 | 默认值 |
| 最小值 | |
| 最大值 |
文档: client_encoding
更改历史记录
- PostgreSQL 6.4
- 添加 (提交 bf00bbb0)
示例
client_encoding 的基本用法示例
postgres=# SHOW client_encoding; client_encoding ----------------- UTF8 (1 row)
尝试设置无效编码
postgres=# SET client_encoding = 'klingon'; ERROR: invalid value for parameter "client_encoding": "klingon"
参考
- PostgreSQL 文档： client_encoding