# 创建转化

CREATE CONVERSION — 定义新的编码转换

# 概要

CREATE [ DEFAULT ] CONVERSION name
    FOR source_encoding TO dest_encoding FROM function_name

# 描述

创建转化定义两个字符集编码之间的新转换。

标记的转化默认可用于客户端和服务器之间的自动编码转换。为了支持这种用法,从编码 A 到 B 的两种转换从编码 B 到 A,必须定义。

为了能够创建转换,您必须拥有执行功能的特权和创建目标模式的特权。

# 参数

默认

默认子句指示此转换是此特定源到目标编码的默认值。编码对的架构中应该只有一个默认编码。

姓名

转换的名称。转换名称可以是模式限定的。如果不是,则在当前模式中定义转换。转换名称在架构中必须是唯一的。

source_encoding

源编码名称。

dest_encoding

目标编码名称。

函数名

用于执行转换的函数。函数名称可以是模式限定的。如果不是,则将在路径中查找该函数。

该函数必须具有以下签名:

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“编码”是硬连线的。

采用丢弃转换删除用户定义的转换。

在未来的版本中可能会更改创建转换所需的权限。

# 例子

从编码创建转换UTF8拉丁语1使用我的函数

CREATE CONVERSION myconv FOR 'UTF8' TO 'LATIN1' FROM myfunc;

# 兼容性

创建转化是一个 PostgreSQL 扩展。没有创建转化SQL 标准中的语句,但是创建翻译目的和语法非常相似的语句。

# 也可以看看

改变转换,创建函数,丢弃转换