支持的版本: 当前 (17) / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1

CREATE COLLATION

CREATE 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

描述

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

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

参数

IF NOT EXISTS

如果存在同名的排序规则,则不抛出错误。在这种情况下会发出通知。请注意,不能保证现有的排序规则与将要创建的排序规则类似。

name

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

locale

此排序规则的区域设置名称。有关详细信息,请参见 第 23.2.2.3.1 节第 23.2.2.3.2 节

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

如果 providerbuiltin,则必须指定 locale 并将其设置为 CC.UTF-8

lc_collate

如果 providerlibc,则使用指定的操作系统的区域设置作为 LC_COLLATE 区域设置类别。

lc_ctype

如果 providerlibc,则使用指定的操作系统的区域设置作为 LC_CTYPE 区域设置类别。

provider

指定用于此排序规则的区域设置服务的提供程序。 可能的值为 builtinicu(如果服务器使用 ICU 支持构建)或 libclibc 是默认值。 有关详细信息,请参见第 23.1.4 节

DETERMINISTIC

指定排序规则是否应使用确定性比较。 默认值为 true。 确定性比较认为,即使在逻辑上被认为是相等的,字节方式不相等的字符串也是不相等的。 PostgreSQL 使用字节方式比较来打破平局。 不确定性的比较可以使排序规则不区分大小写或重音符号。 为此,您需要选择合适的 LOCALE 设置并且在此处将排序规则设置为非确定性的。

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

rules

指定其他排序规则以自定义排序规则的行为。 这仅适用于 ICU。 有关详细信息,请参见第 23.2.3.4 节

version

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

另请参见 ALTER COLLATION,了解如何处理排序规则版本不匹配的情况。

existing_collation

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

备注

CREATE COLLATIONpg_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 扩展。

提交更正

如果您在文档中发现任何不正确、与特定功能不符或需要进一步说明的地方,请使用此表单报告文档问题。