CREATE CONVERSION

简介

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

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

要创建一个转换，你必须拥有该函数上的EXECUTE特权以及目标模式上的CREATE特权。

语法

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

参数

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

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

source_encoding源编码名称。

dest_encoding目标编码名称。

function_name被用来执行转换的函数。函数名可以被模式限定。如果没有，将在路径中查找该函数。

该函数必须具有以下的特征：

    conv_proc(
        integer,  -- 源编码 ID
        integer,  -- 目标编码 ID
        cstring,  -- 源字符串（空值终止的 C 字符串）
        internal, -- 目标（用一个空值终止的 C 字符串填充）
        integer   -- 源字符串长度
    ) RETURNS void;

说明

源编码和目标编码都不可以是SQL_ASCII， 因为在涉及SQL_ASCII “encoding”的情况下， 服务器的行为是硬连接的。

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

创建转换所要求的特权可能在未来的发行中被更改。

示例

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

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