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

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

Wiki / SQL 命令

CREATE CONVERSION

定义一个新的编码转换

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

7.37.48.08.18.28.38.49.09.19.29.39.49.59.61011121314151617181920
anchor
SQL-CREATECONVERSION
file
sql-createconversion.html
lang
en
name
CREATE CONVERSION
purpose
define a new encoding conversion
purpose zh
未知
sections same as
未知
slug
18
synopsis text
CREATE [ DEFAULT ] CONVERSION name FOR source_encoding TO dest_encoding FROM function_name

语法

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

从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。

CREATE DEFAULT CONVERSION name FOR source_encoding TO dest_encoding FROM function_name

版本定义 PG 18

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,  -- 源编码 ID
    integer,  -- 目标编码 ID
    cstring,  -- 源字符串（以空字符结尾的 C 字符串）
    internal, -- 目标（填充为以空字符结尾的 C 字符串）
    integer,  -- 源字符串长度
    boolean   -- 如果为 true，则在转换失败时不要抛出错误
) 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语句。

另见

ALTER CONVERSION, CREATE FUNCTION, DROP CONVERSION

比较版本

完整来源事实

synopsis html

CREATE [ DEFAULT ] CONVERSION <em class="replaceable"><code>name</code></em>
    FOR <em class="replaceable"><code>source_encoding</code></em> TO <em class="replaceable"><code>dest_encoding</code></em> FROM <em class="replaceable"><code>function_name</code></em>

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c