PostgreSQL 中文参考文档
🌐 英文原版 官方 ↗

CREATE COLLATION

CREATE COLLATION — 定义一个新的排序规则

Synopsis

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

描述

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

要能够创建排序规则,你必须在目标模式上拥有 CREATE 特权。

参数

IF NOT EXISTS

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

name

该排序规则的名称。排序规则名称可以带模式限定。如果不带,则排序规则定义在当前模式中。排序规则名称在该模式中必须唯一。(系统目录可以包含针对其他编码的同名排序规则,但如果数据库编码不匹配,这些排序规则将被忽略。)

locale

此排序规则的区域名称。详情请参阅 Section 23.2.2.3.1 和 Section 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。详情请参阅 Section 23.1.4。

DETERMINISTIC

指定该排序规则是否应使用确定性比较。默认为真。确定性比较认为逐字节不相等的字符串是不相等的,即使它们在比较中被认为逻辑上相等。PostgreSQL 会使用逐字节比较来打破平局。非确定性的比较可以使排序规则变得(比如说)不区分大小写或不区分重音。为此,你需要选择一个合适的 LOCALE 设置,并且在这里把排序规则设置为非确定性的。

非确定性排序规则只有 ICU 提供者才支持。

rules

指定用于自定义该排序规则行为的额外排序规则。该选项仅受 ICU 支持。详情请参阅 Section 23.2.3.4。

version

指定要与该排序规则一起存储的版本字符串。通常应省略此选项,这样版本将根据操作系统提供的该排序规则的实际版本计算得到。此选项旨在供 pg_upgrade 用于从现有安装复制版本。

有关如何处理排序规则版本不匹配的信息,另请参阅 ALTER COLLATION。

existing_collation

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

注记

CREATE COLLATION 会获取一个 SHARE ROW EXCLUSIVE 锁(该锁是自冲突的),作用于 pg_collation 系统目录,因此一次只能运行一个 CREATE COLLATION 命令。

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

有关如何创建排序规则的更多信息,请参阅 Section 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');

有关规则语法的更多细节和示例,请参阅 Section 23.2.3.4。

从一个现有的排序规则创建排序规则:

CREATE COLLATION german FROM "de_DE";

这对于在应用程序中使用独立于操作系统的排序规则名称会很方便。

兼容性

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

另请参阅

ALTER COLLATION, DROP COLLATION