CREATE CONVERSION — 定义新的编码转换
CREATE [ DEFAULT ] CONVERSIONname
FORsource_encoding
TOdest_encoding
FROMfunction_name
CREATE CONVERSION
定义两种字符集编码之间的新的转换。
标记为 DEFAULT
的转换可用于客户端和服务器之间的自动编码转换。为了支持这种用法,必须定义两个转换,从编码 A 到 B 和 从编码 B 到 A。
要能够创建转换,您必须对该函数拥有 EXECUTE
权限,并且对目标架构拥有 CREATE
权限。
DEFAULT
DEFAULT
子句表示此转换是此特定源到目标编码的默认值。架构中对于编码对应该只有一个默认编码。
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
语句,其目的和语法非常相似。