SQL COMMAND · 类型与运算符

CREATE CONVERSION

定义一个新的编码转换

CREATE类型与运算符引入 10（基线）现存至 20 devel0 次语法变更

动词: CREATE
对象: CONVERSION
分组: 类型与运算符
引入版本: 10（基线）
状态: 现存
语法变更次数: 0
手册小节数: 6

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

语法概要

CREATE [ DEFAULT ] CONVERSION name
    FOR source_encoding TO dest_encoding FROM function_name

PostgreSQL 18 手册 · 查看完整参考页

描述

CREATE CONVERSION定义两个字符集编码之间的一种新转换。

标记为DEFAULT的转换可用于客户端与服务器之间的自动编码转换。要支持这种用法，必须同时定义两个转换，即从编码 A 到 B 以及从编码 B 到 A。

要创建一个转换，你必须对该函数具有EXECUTE权限，并在目标模式上具有CREATE权限。

参数

DEFAULT

DEFAULT子句表示该转换是这一特定源编码到目标编码的默认转换。对于某个编码对，在一个模式中应该只有一个默认转换。

name

转换的名称。转换名可以是模式限定的；如果不是，则该转换定义在当前模式中。转换名在一个模式中必须唯一。

source_encoding

源编码名称。

dest_encoding

目标编码名称。

function_name

用于执行该转换的函数。函数名可以是模式限定的；如果不是，则会在搜索路径中查找该函数。

该函数必须具有以下签名：

conv_proc(
    integer,  -- 源编码 ID
    integer,  -- 目标编码 ID
    cstring,  -- 源字符串（以空字符结尾的 C 字符串）
    internal, -- 目标（填充为以空字符结尾的 C 字符串）
    integer,  -- 源字符串长度
    boolean   -- 如果为 true，则在转换失败时不要抛出错误
) RETURNS integer;

返回值是成功转换的源字节数。如果最后一个参数为 false，则函数必须在输入无效时抛出错误，并且返回值始终等于源字符串长度。

注解

源编码和目标编码都不能是SQL_ASCII，因为对于涉及SQL_ASCII “编码”的情况，服务器的行为是硬编码的。

使用DROP CONVERSION可以删除用户定义的转换。

创建转换所要求的权限在未来版本中可能会更改。

示例

使用myfunc创建从编码UTF8到 LATIN1的转换：

CREATE CONVERSION myconv FOR 'UTF8' TO 'LATIN1' FROM myfunc;

兼容性

CREATE CONVERSION是 PostgreSQL的一个扩展。SQL 标准中没有CREATE CONVERSION语句，但有一个在目的和语法上都非常相似的 CREATE TRANSLATION语句。

另见

ALTER CONVERSION, CREATE FUNCTION, DROP CONVERSION

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

PostgreSQL 14← 13正文更新

正文更新
PostgreSQL 13← 12正文更新

正文更新

同组命令

命令	动词	对象	最近变更
TYPES & OPERATORS类型与运算符23 条↑
`CREATE CAST`	CREATE	CAST	—
定义一种新的类型转换			现存
`DROP CAST`	DROP	CAST	—
移除一个类型转换			现存
`CREATE COLLATION`	CREATE	COLLATION	142 次
定义一种新排序规则			现存
`ALTER COLLATION`	ALTER	COLLATION	141 次
更改排序规则的定义			现存
`DROP COLLATION`	DROP	COLLATION	—
删除一个排序规则			现存
`CREATE CONVERSION`	CREATE	CONVERSION	—
定义一个新的编码转换			现存
`ALTER CONVERSION`	ALTER	CONVERSION	141 次
更改一个转换的定义			现存
`DROP CONVERSION`	DROP	CONVERSION	—
移除一个转换			现存
`CREATE DOMAIN`	CREATE	DOMAIN	142 次
定义一个新域			现存
`ALTER DOMAIN`	ALTER	DOMAIN	142 次
更改一个域的定义			现存
`DROP DOMAIN`	DROP	DOMAIN	—
移除一个域			现存
`CREATE OPERATOR`	CREATE	OPERATOR	192 次
定义一个新的操作符			现存
`ALTER OPERATOR`	ALTER	OPERATOR	141 次
更改一个操作符的定义			现存
`DROP OPERATOR`	DROP	OPERATOR	141 次
移除一个操作符			现存
`CREATE OPERATOR CLASS`	CREATE	OPERATOR CLASS	—
定义一个新的操作符类			现存
`ALTER OPERATOR CLASS`	ALTER	OPERATOR CLASS	141 次
更改一个操作符类的定义			现存
`DROP OPERATOR CLASS`	DROP	OPERATOR CLASS	—
移除一个操作符类			现存
`CREATE OPERATOR FAMILY`	CREATE	OPERATOR FAMILY	—
定义一个新的操作符族			现存
`ALTER OPERATOR FAMILY`	ALTER	OPERATOR FAMILY	141 次
更改一个操作符族的定义			现存
`DROP OPERATOR FAMILY`	DROP	OPERATOR FAMILY	—
移除一个操作符族			现存
`CREATE TYPE`	CREATE	TYPE	141 次
定义一种新的数据类型			现存
`ALTER TYPE`	ALTER	TYPE	142 次
更改类型的定义			现存
`DROP TYPE`	DROP	TYPE	—
移除一个数据类型			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

注解

示例

兼容性

另见

语法演化

相关命令

同组命令