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
FROMexisting_collation
CREATE COLLATION
使用指定的操作系统区域设置(locale)来定义一个新的排序规则,或者通过复制现有的排序规则来创建。
要能够创建排序规则,您必须对目标模式(schema)拥有 CREATE
权限。
IF NOT EXISTS
如果同名的排序规则已存在,则不会报错,而是会发出一个通知。请注意,这并不保证现有的排序规则与将被创建的排序规则有任何相似之处。
name
排序规则的名称。排序规则名称可以包含模式限定。如果未包含,则排序规则在当前模式下定义。排序规则名称在该模式下必须是唯一的。(系统目录可能包含具有相同名称但不同编码的排序规则,但如果数据库编码不匹配,这些将被忽略。)
locale
此排序规则的 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
locale 分类使用指定的操作系统 locale。
lc_ctype
如果 provider
是 libc
,则为 LC_CTYPE
locale 分类使用指定的操作系统 locale。
provider
指定用于此排序规则的 locale 服务的提供程序。可能的值为 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
排序规则提供程序时,locale 必须适用于当前数据库编码。有关精确规则,请参阅 CREATE DATABASE。
要从操作系统 locale 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 根 locale,并带有自定义规则来创建排序规则
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 扩展支持创建新排序规则的语法。
如果您在文档中发现任何不正确、与您对特定功能的体验不符或需要进一步说明的内容,请使用 此表单 来报告文档问题。