CREATE COLLATION
CREATE COLLATION — 定义一种新排序规则
大纲
CREATE COLLATION [ IF NOT EXISTS ]name( [ LOCALE =locale, ] [ LC_COLLATE =lc_collate, ] [ LC_CTYPE =lc_ctype, ] [ PROVIDER =provider, ] [ VERSION =version] ) CREATE COLLATION [ IF NOT EXISTS ]nameFROMexisting_collation
描述
CREATE COLLATION 使用指定的操作系统区域设置,或者通过复制现有排序规则,定义一个新的排序规则。
要创建排序规则,你必须拥有目标模式上的
CREATE 权限。
参数
IF NOT EXISTS如果同名的排序规则已存在,则不抛出错误。在这种情况下会发出通知。请注意,无法保证现有的排序规则与本应创建的排序规则相似。
name排序规则的名称。排序规则名称可以带有模式限定。如果没有,排序规则将在当前模式中定义。排序规则名称在该模式中必须唯一。(系统目录中可能包含其他编码的同名排序规则,但如果数据库编码不匹配,则这些排序规则将被忽略。)
locale这是同时设置
LC_COLLATE和LC_CTYPE的快捷方式。如果指定了此选项,则不能指定这两个参数中的任何一个。lc_collate为
LC_COLLATE区域类别使用指定的操作系统区域设置。lc_ctype为
LC_CTYPE区域类别使用指定的操作系统区域设置。provider指定用于与此排序规则关联的区域设置服务的提供程序。可能的值为:
icu,libc。libc是默认值。可用选项取决于操作系统和构建选项。version指定随该排序规则存储的版本字符串。通常应省略该选项,这样版本就会根据操作系统提供的该排序规则实际版本来计算。此选项旨在供
pg_upgrade从现有安装中复制版本时使用。另见 ALTER COLLATION,了解如何处理排序规则版本不匹配的问题。
existing_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');
从现有排序规则创建排序规则:
CREATE COLLATION german FROM "de_DE";
这在应用程序中使用与操作系统无关的排序规则名称时非常方便。
兼容性
在 SQL 标准中有一个 CREATE COLLATION
语句,但它仅限于复制现有排序规则。创建新排序规则的语法是
PostgreSQL 扩展。