受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: devel

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

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

注解

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

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

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

示例

使用myfunc创建从编码UTF8LATIN1的转换:

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

兼容性

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

提交更正

如果您发现文档中有不正确的内容、与您使用特定功能的经验不符或需要进一步说明,请使用此表单来报告文档问题。