PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

CREATE CONVERSION

CREATE CONVERSION — 定义一个新的编码转换

Synopsis

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

描述

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

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

要能够创建转换,你必须对该函数拥有 EXECUTE 特权,并且对目标模式拥有 CREATE 特权。

参数

DEFAULT

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

name

该转换的名称。转换名称可以用模式限定。如果没有限定,则该转换将被定义在当前模式中。转换名称在一个模式内必须唯一。

source_encoding

源编码的名称。

dest_encoding

目标编码的名称。

function_name

用于执行转换的函数。函数名称可以用模式限定。如果没有限定,将在搜索路径中查找该函数。

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

conv_proc(
    integer,  -- source encoding ID
    integer,  -- destination encoding ID
    cstring,  -- source string (null terminated C string)
    internal, -- destination (fill with a null terminated C string)
    integer,  -- source string length
    boolean   -- if true, don't throw an error if conversion fails
) RETURNS integer;

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

注记

源编码和目标编码都不能是 SQL_ASCII,因为服务器在涉及 SQL_ASCII “编码”的情形下的行为是硬编码的。

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

创建转换所需的特权在未来的版本中可能会发生变化。

示例

要创建一个从编码 UTF8 到 LATIN1 并使用 myfunc 的转换:

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

兼容性

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

另请参阅

ALTER CONVERSION, CREATE FUNCTION, DROP CONVERSION