↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 命令 / 类型与运算符

SQL COMMAND · 类型与运算符

CREATE CONVERSION

定义一个新的编码转换

define a new encoding conversion

CREATE类型与运算符引入 7.3现存至 20 devel2 次语法变更

动词
CREATE
对象
CONVERSION
引入版本
7.3
状态
现存
语法变更次数
2
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

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

PostgreSQL 18 手册 · 查看完整参考页

描述

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 语句。

另见

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 14← 13正文更新

    正文更新
  2. PostgreSQL 13← 12正文更新

    正文更新
  3. PostgreSQL 9.0← 8.4语法变化

    + FOR source_encoding TO dest_encoding FROM function_name− FOR source_encoding TO dest_encoding FROM funcname正文更新
  4. PostgreSQL 8.3← 8.2正文更新

    正文更新
  5. PostgreSQL 8.1← 8.0正文更新

    正文更新
  6. PostgreSQL 7.4← 7.3语法变化

    + CREATE [DEFAULT] CONVERSION name− CREATE [DEFAULT] CONVERSION conversion_name正文更新
  7. PostgreSQL 7.3← 7.2新增此命令

同组命令

命令动词对象版本变动最近变更
TYPES & OPERATORS类型与运算符23 条↑
CREATE CASTCREATECAST 104 次
定义一种新的类型转换现存
DROP CASTDROPCAST 9.02 次
移除一个类型转换现存
CREATE COLLATIONCREATECOLLATION 163 次
定义一种新排序规则现存
ALTER COLLATIONALTERCOLLATION 143 次
更改排序规则的定义现存
DROP COLLATIONDROPCOLLATION —
删除一个排序规则现存
CREATE CONVERSIONCREATECONVERSION 9.02 次
定义一个新的编码转换现存
ALTER CONVERSIONALTERCONVERSION 145 次
更改一个转换的定义现存
DROP CONVERSIONDROPCONVERSION 8.22 次
移除一个转换现存
CREATE DOMAINCREATEDOMAIN 174 次
定义一个新域现存
ALTER DOMAINALTERDOMAIN 145 次
更改一个域的定义现存
DROP DOMAINDROPDOMAIN 8.22 次
移除一个域现存
CREATE OPERATORCREATEOPERATOR 198 次
定义一个新的操作符现存
ALTER OPERATORALTEROPERATOR 176 次
更改一个操作符的定义现存
DROP OPERATORDROPOPERATOR 148 次
移除一个操作符现存
CREATE OPERATOR CLASSCREATEOPERATOR CLASS 9.15 次
定义一个新的操作符类现存
ALTER OPERATOR CLASSALTEROPERATOR CLASS 145 次
更改一个操作符类的定义现存
DROP OPERATOR CLASSDROPOPERATOR CLASS 8.22 次
移除一个操作符类现存
CREATE OPERATOR FAMILYCREATEOPERATOR FAMILY —
定义一个新的操作符族现存
ALTER OPERATOR FAMILYALTEROPERATOR FAMILY 146 次
更改一个操作符族的定义现存
DROP OPERATOR FAMILYDROPOPERATOR FAMILY —
移除一个操作符族现存
CREATE TYPECREATETYPE 1413 次
定义一种新数据类型现存
ALTER TYPEALTERTYPE 148 次
更改类型的定义现存
DROP TYPEDROPTYPE 8.24 次
移除一个数据类型现存