↑↓ 选择↵ 打开⌫ 切换范围完整搜索

PG.CENTER 连接 PostgreSQL 文档、百科与生态知识。由 Pigsty 维护。

支持中的版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发中的版本: 19 / 20devel
已结束支持的版本: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3
历史版本。 PostgreSQL 9.2 已结束支持。 2017-11-09. 请参阅 当前版本手册.

CREATE CONVERSION

CREATE CONVERSION — 定义一个新的编码转换

大纲

CREATE [ DEFAULT ] CONVERSION name
    FOR source_encoding TO dest_encoding FROM function_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
) RETURNS void;

注解

使用DROP CONVERSION可以删除用户定义的转换。

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

示例

使用myfunc创建从编码UTF8到 LATIN1的转换:

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

兼容性

CREATE CONVERSION是 PostgreSQL的一个扩展。SQL 标准中没有CREATE CONVERSION语句,但有一个在目的和语法上都非常相似的 CREATE TRANSLATION语句。

报告文档问题

阅读 上游文档. 反馈更正前请先核对 当前版本手册.