CREATE CONVERSION

CREATE CONVERSION — 定义新的编码转换

语法

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删除用户定义的转换。

创建转换所需的权限可能会在将来的版本中更改。

示例

使用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