CREATE CONVERSION — 定义一个新的编码转换
CREATE [ DEFAULT ] CONVERSIONnameFORsource_encodingTOdest_encodingFROMfunction_name
CREATE CONVERSION 定义两个字符集编码之间的新转换。
标记为 DEFAULT 的转换可用于客户端和服务器之间的自动编码转换。为了支持这种用法,必须定义两个转换,从编码 A 到 B 和 从编码 B 到 A。
要能够创建转换,您必须拥有该函数的 EXECUTE 权限和目标模式的 CREATE 权限。
DEFAULTDEFAULT 子句指示此转换是此特定源到目标编码的默认转换。对于编码对,一个模式中应该只有一个默认编码。
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 CONVERSION 是 PostgreSQL 的扩展。SQL 标准中没有 CREATE CONVERSION 语句,但有一个 CREATE TRANSLATION 语句,其目的和语法非常相似。
如果您在文档中发现任何不正确、与您使用特定功能的经验不符或需要进一步澄清的内容,请使用此表单报告文档问题。