pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。
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 ]nameFROMexisting_collation
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扩展。
译文有误、术语不当或页面显示问题,请到译文仓库 pgsty/pgdoc 报告译文问题。英文原文本身的问题请通过上游文档表单反馈给 PostgreSQL 文档维护者。