CREATE CONVERSION
CREATE CONVERSION — 定义一个新的编码转换
大纲
CREATE [ DEFAULT ] CONVERSIONnameFORsource_encodingTOdest_encodingFROMfunction_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 创建从编码 UTF8 到
LATIN1 的转换:
CREATE CONVERSION myconv FOR 'UTF8' TO 'LATIN1' FROM myfunc;
兼容性
CREATE CONVERSION 是
PostgreSQL 的一个扩展。SQL 标准中没有 CREATE CONVERSION 语句,但有一个在目的和语法上都非常相似的
CREATE TRANSLATION 语句。
报告文档问题
阅读 上游文档. 通过 PostgreSQL 文档反馈表单.