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

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

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

SQL COMMAND · 类型与运算符

CREATE COLLATION

定义一种新排序规则

define a new collation

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

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

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 语法未变，正文有更新。

语法铁道图 PostgreSQL 18

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

CREATE COLLATION IF NOT EXISTS name ( LOCALE = locale , LC_COLLATE = lc_collate , LC_CTYPE = lc_ctype , PROVIDER = provider , DETERMINISTIC = boolean , RULES = rules , VERSION = version )
CREATE COLLATION · 语法 2
CREATE COLLATION IF NOT EXISTS name FROM existing_collation

语法概要

CREATE COLLATION [ IF NOT EXISTS ] name (
[ LOCALE = locale, ]
[ LC_COLLATE = lc_collate, ]
[ LC_CTYPE = lc_ctype, ]
[ PROVIDER = provider, ]
[ DETERMINISTIC = boolean, ]
[ RULES = rules, ]
[ VERSION = version ]
)
CREATE COLLATION [ IF NOT EXISTS ] name FROM existing_collation

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

描述

CREATE COLLATION 使用指定的操作系统区域设置，或者通过复制现有排序规则，定义一个新的排序规则。

要创建排序规则，你必须拥有目标模式上的 CREATE 权限。

参数

IF NOT EXISTS

如果同名排序规则已经存在，则不要抛出错误。在这种情况下会发出一条通知。请注意，不保证现有的排序规则与本应创建出的排序规则有任何相似之处。

name

排序规则的名称，可以使用模式限定。若未使用模式限定，则该排序规则会在当前模式中定义。排序规则名称在该模式内必须唯一。（系统目录中可以包含针对其他编码的同名排序规则，但如果数据库编码不匹配，则会忽略它们。）

locale

该排序规则的区域设置名称。详见第 23.2.2.3.1 节和第 23.2.2.3.2 节。

如果 provider 是 libc，这相当于同时设置 LC_COLLATE 和 LC_CTYPE。如果指定了 locale，则不能再指定这两个参数中的任何一个。

如果 provider 是 builtin，则必须指定 locale，且其值只能是 C、C.UTF-8 或 PG_UNICODE_FAST。

lc_collate

如果 provider 是 libc，则对 LC_COLLATE 区域类别使用指定的操作系统区域设置。

lc_ctype

如果 provider 是 libc，则对 LC_CTYPE 区域类别使用指定的操作系统区域设置。

provider

指定与该排序规则关联的区域设置服务所使用的提供程序。可能的值是 builtin、icu（如果服务器在构建时启用了 ICU 支持）或 libc。默认值是 libc。详见第 23.1.4 节。

DETERMINISTIC

指定该排序规则是否应使用确定性比较。默认值为 true。确定性比较认为，凡不是按字节完全相等的字符串，即使比较在逻辑上认为它们相等，也应视为不相等。PostgreSQL 会使用按字节比较来打破平局。非确定性比较可以使排序规则例如不区分大小写或重音。要实现这一点，你需要选择合适的 LOCALE 设置并在此处将排序规则设为非确定性。

非确定性排序规则仅受 ICU 提供程序支持。

rules

指定额外的定制规则，以自定义该排序规则的行为。这仅受 ICU 支持。详见第 23.2.3.4 节。

version

指定随该排序规则存储的版本字符串。通常应省略该选项，这样版本就会根据操作系统提供的该排序规则实际版本来计算。此选项旨在供 pg_upgrade 从现有安装中复制版本时使用。

另见 ALTER COLLATION，了解如何处理排序规则版本不匹配的问题。

existing_collation

要复制的现有排序规则的名称。新的排序规则将具有与现有排序规则相同的属性，但它是一个独立对象。

注解

CREATE COLLATION 会在 pg_collation 系统目录上获取一个 SHARE ROW EXCLUSIVE 锁。该锁是自冲突的，因此一次只能运行一条 CREATE COLLATION 命令。

使用 DROP COLLATION 可移除用户定义的排序规则。

关于如何创建排序规则的更多信息，见第 23.2.2.3 节。

使用 libc 排序规则提供者时，区域设置必须适用于当前数据库编码。有关精确规则，请参见 CREATE DATABASE。

示例

从操作系统区域设置 fr_FR.utf8 创建一种排序规则（假定当前数据库编码是 UTF8）： 

CREATE COLLATION french (locale = 'fr_FR.utf8');

使用 ICU 提供程序并采用德语电话簿排序顺序创建一种排序规则： 

CREATE COLLATION german_phonebook (provider = icu, locale = 'de-u-co-phonebk');

使用 ICU 提供程序、基于 ICU 根区域设置并带有自定义规则创建一种排序规则： 

CREATE COLLATION custom (provider = icu, locale = 'und', rules = '&V << w <<< W');

关于规则语法的更多细节和示例，见第 23.2.3.4 节。

通过复制现有排序规则来创建一种排序规则： 

CREATE COLLATION german FROM "de_DE";

这样在应用程序中使用与操作系统无关的排序规则名称会比较方便。

兼容性

在 SQL 标准中有一个 CREATE COLLATION 语句，但它仅限于复制现有排序规则。创建新排序规则的语法是 PostgreSQL 扩展。

另见

ALTER COLLATION, DROP COLLATION

语法演化

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

  1. PostgreSQL 18← 17正文更新

    正文更新

  2. PostgreSQL 17← 16正文更新

    正文更新

  3. PostgreSQL 16← 15语法变化

    + [ RULES = rules, ]+ [ VERSION = version ]正文更新

  4. PostgreSQL 14← 13正文更新

    正文更新

  5. PostgreSQL 12← 11语法变化

    + [ DETERMINISTIC = boolean, ]+ [ VERSION = version ]正文更新

  6. PostgreSQL 10← 9.6语法变化

    + CREATE COLLATION [ IF NOT EXISTS ] name (+ [ LC_CTYPE = lc_ctype, ]+ [ PROVIDER = provider, ]+ [ VERSION = version ]+ CREATE COLLATION [ IF NOT EXISTS ] name FROM existing_collation正文更新

  7. PostgreSQL 9.6← 9.5正文更新

    正文更新

  8. PostgreSQL 9.1← 9.0新增此命令

同组命令

命令动词对象版本变动最近变更
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 次
移除一个数据类型现存