Postgresql 中文操作指南

CREATE CONVERSION

CREATE CONVERSION — 定义新的编码转换

Synopsis

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

Description

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

标记为 DEFAULT 的转换可用于在客户端和服务器之间进行自动编码转换。为了支持此用法，必须定义两个转换：从编码 A 到 B and 从编码 B 到 A。

要能够创建一个转换，您必须对该函数拥有 EXECUTE 权限，并对目标模式拥有 CREATE 权限。

Parameters

DEFAULT
- DEFAULT 子句表明此转换对于此特定的源头到目标的编码为默认值。在编码对的模式中应仅有一个默认编码。
name
- 转换名称。转换名称可以是模式限定的。如果不限定，则在当前模式中定义转换。转换名称在模式中必须是唯一的。
source_encoding
- The source encoding name.
dest_encoding
- The destination encoding name.
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，则函数必须为无效输入抛出一个错误，并且该返回值始终与源字符串长度相等。

Notes

源和目标编码都不能是 SQL_ASCII ，因为服务器针对涉及 SQL_ASCII “编码” 的场景的行为已固化。

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

创建转换所需的权限在未来的版本中可能发生更改。

Examples

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

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

Compatibility

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