2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3

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 CONVERSIONPostgreSQL 的一个扩展。SQL 标准中没有 CREATE CONVERSION 语句,但有一个 CREATE TRANSLATION 语句,在目的和语法上与此非常相似。

提交更正

如果您在文档中发现任何不正确之处,与您在使用该特定功能时的体验不符,或需要进一步澄清,请使用 此表单 报告文档问题。