历史版本。 PostgreSQL 8.1 已结束支持。 请参阅 当前版本手册.
CREATE CONVERSION
CREATE CONVERSION — 定义一个新的编码转换
大纲
CREATE [DEFAULT] CONVERSIONnameFORsource_encodingTOdest_encodingFROMfuncname
描述
CREATE CONVERSION 定义字符集编码之间的新转换。转换名可以在convert函数中用来指定一个特定的编码转换。此外,被标记为 DEFAULT 的转换可用于客户端与服务器之间的自动编码转换。为此目的,必须定义两个转换:从编码 A 到 B 以及从编码 B 到 A。
要创建一个转换,你必须对该函数具有EXECUTE权限,并在目标模式上具有CREATE权限。
参数
DEFAULTDEFAULT子句表示该转换是这一特定源编码到目标编码的默认转换。对于某个编码对,在一个模式中应该只有一个默认转换。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可以删除用户定义的转换。
创建转换所要求的权限在未来版本中可能会更改。
示例
使用myfunc创建从编码UTF8到
LATIN1的转换:
CREATE CONVERSION myconv FOR 'UTF8' TO 'LATIN1' FROM myfunc;
兼容性
CREATE CONVERSION是
PostgreSQL的一个扩展。SQL 标准中没有CREATE CONVERSION语句。