CREATE CONVERSION
CREATE CONVERSION — 定义一个用户定义的编码转换
大纲
CREATE [DEFAULT] CONVERSIONconversion_nameFORsource_encodingTOdest_encodingFROMfuncname
描述
CREATE CONVERSION定义一个新的编码转换。转换名可以用在 CONVERT() 函数中来指定一个特定的编码转换。此外,标记为 DEFAULT 的转换可用于前端和后端之间的自动编码转换。为此目的,必须定义两个转换:从编码 A 到 B
以及从编码 B 到 A。
要能够创建转换,你必须对该函数拥有执行权限,并对目标模式拥有创建权限。
参数
DEFAULTDEFAULT子句表示这个转换是这一特定的源编码到目标编码的默认转换。在一个模式中,对于一对编码只应有一个默认转换。conversion_name转换的名称。转换名可以是模式限定的。如果不是,转换定义在当前模式中。转换名在一个模式内必须唯一。
source_encoding源编码名称。
dest_encoding目标编码名称。
funcname执行转换所用的函数。函数名可以是模式限定的。如果不是,函数将在路径中查找。
该函数必须具有下面的签名:
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 ) returns VOID;
注解
使用DROP CONVERSION删除用户定义的转换。
创建转换所需的权限在将来的版本中可能会更改。
示例
要创建一个从编码 UNICODE 到 LATIN1 的转换,使用myfunc:
CREATE CONVERSION myconv FOR 'UNICODE' TO 'LATIN1' FROM myfunc;
兼容性
CREATE CONVERSION
是PostgreSQL的一个扩展。没有CREATE CONVERSION
语句出现在 SQL99 中。
另见
CREATE FUNCTION, DROP CONVERSION, PostgreSQL 程序员指南