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

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 7.3 已结束支持。 请参阅 当前版本手册.

CREATE CONVERSION

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

大纲

CREATE [DEFAULT] CONVERSION conversion_name
    FOR source_encoding TO dest_encoding FROM funcname

描述

CREATE CONVERSION定义一个新的编码转换。转换名可以用在 CONVERT() 函数中来指定一个特定的编码转换。此外,标记为 DEFAULT 的转换可用于前端和后端之间的自动编码转换。为此目的,必须定义两个转换:从编码 A 到 B 以及从编码 B 到 A。

要能够创建转换,你必须对该函数拥有执行权限,并对目标模式拥有创建权限。

参数

DEFAULT

DEFAULT子句表示这个转换是这一特定的源编码到目标编码的默认转换。在一个模式中,对于一对编码只应有一个默认转换。

conversion_name

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

source_encoding

源编码名称。

dest_encoding

目标编码名称。

funcname

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

该函数必须具有下面的签名:

	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删除用户定义的转换。

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

示例

要创建一个从编码 UNICODE 到 LATIN1 的转换,使用myfunc:

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

兼容性

CREATE CONVERSION 是PostgreSQL的一个扩展。没有CREATE CONVERSION 语句出现在 SQL99 中。

另见

CREATE FUNCTION, DROP CONVERSION, PostgreSQL 程序员指南

报告文档问题

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