选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 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, ]
    [ VERSION = version ]
)
CREATE COLLATION [ IF NOT EXISTS ] name FROM existing_collation

描述

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

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

参数

IF NOT EXISTS

如果同名的排序规则已存在,则不抛出错误。在这种情况下会发出通知。请注意,无法保证现有的排序规则与本应创建的排序规则相似。

name

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

locale

这是同时设置 LC_COLLATELC_CTYPE 的快捷方式。如果指定了此选项,则不能指定这两个参数中的任何一个。

lc_collate

LC_COLLATE 区域类别使用指定的操作系统区域设置。

lc_ctype

LC_CTYPE 区域类别使用指定的操作系统区域设置。

provider

指定用于与此排序规则关联的区域设置服务的提供者。可能的值为: icu libclibc 是默认值。可用选项取决于操作系统和构建选项。

DETERMINISTIC

指定排序规则是否应使用确定性比较。默认值为 true。确定性比较将字节上不相等的字符串视为不相等,即使它们在逻辑上相等。PostgreSQL 使用字节比较来解决歧义。非确定性比较可以使排序规则变为大小写不敏感或重音不敏感。为此,您需要选择适当的 LOCALE 设置 并且 在此处将排序规则设置为非确定性。

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

version

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

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

existing_collation

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

注解

CREATE COLLATION会在pg_collation 系统目录上获取一个SHARE ROW EXCLUSIVE锁。该锁是 自冲突的,因此一次只能运行一条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');

从现有排序规则创建排序规则:

CREATE COLLATION german FROM "de_DE";

这在应用程序中使用与操作系统无关的排序规则名称时非常方便。

兼容性

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