CREATE COLLATION
CREATE COLLATION — создать правило сортировки
Синтаксис
CREATE COLLATION [ IF NOT EXISTS ]имя
( [ LOCALE =локаль
, ] [ LC_COLLATE =категория_сортировки
, ] [ LC_CTYPE =категория_типов_символов
, ] [ PROVIDER =провайдер
, ] [ DETERMINISTIC =логическое_значение
, ] [ RULES =правила
, ] [ VERSION =версия
] ) CREATE COLLATION [ IF NOT EXISTS ]имя
FROMсуществующее_правило
Описание
CREATE COLLATION
определяет новое правило сортировки, используя параметры локали операционной системы, либо копируя существующее правило.
Чтобы создать правило сортировки, необходимо иметь право CREATE
в целевой схеме.
Параметры
IF NOT EXISTS
Не считать ошибкой, если правило сортировки с таким именем уже существует. В этом случае будет выдано замечание. Заметьте, что нет никакой гарантии, что существующее правило сортировки как-то соотносится с тем, которое могло бы быть создано.
имя
Имя правила сортировки, возможно, дополненное схемой. Если схема не указана, правило сортировки создаётся в текущей схеме. Заданное имя правила должно быть уникальным в этой схеме. (Системные каталоги могут содержать правила сортировки с одним именем, но предназначенные для разных кодировок, однако они будут игнорироваться, если их кодировка не совпадает с кодировкой базы данных.)
локаль
Имя локали для правила сортировки. За подробностями обратитесь к Подразделу 22.2.2.3.1 и Подразделу 22.2.2.3.2.
Если указан
провайдер
libc
, это краткая запись для одновременной установкиLC_COLLATE
иLC_CTYPE
. Если указаналокаль
, задать любой из этих параметров отдельно нельзя.категория_сортировки
Если указан
провайдер
libc
, указанная локаль операционной системы устанавливается в качестве категории локалиLC_COLLATE
.категория_типов_символов
Если указан
провайдер
libc
, указанная локаль операционной системы устанавливается в качестве категории локалиLC_CTYPE
.провайдер
Задаёт провайдер, который будет использоваться для функций локализации, связанных с данным правилом сортировки. Возможные значения:
icu
(если сервер собран с поддержкой ICU) илиlibc
. По умолчанию выбираетсяlibc
. За подробностями обратитесь к Подразделу 22.1.4.DETERMINISTIC
Определяет, будет ли правило сортировки использовать детерминированное сравнение. По умолчанию выбирается именно такое сравнение. При детерминированном сравнении строки, состоящие из различных байтов, считаются неравными, даже если на логическом уровне они одинаковы. Postgres Pro решает вопрос их равенства, сравнивая их по байтам. Если же для правила сортировки выбрать недетерминированное сравнение, это правило может стать, например, независящим от ударения или регистра символов. Для этого необходимо выбрать подходящее значение
LOCALE
и сделать это правило сортировки недетерминированным.Недетерминированные правила сортировки поддерживаются только с провайдером ICU.
правила
Указывает дополнительные правила для настройки поведения сортировки. Параметр поддерживается только для ICU. За дополнительной информацией обратитесь к Подразделу 22.2.3.4.
версия
Задаёт строку версии, сохраняемую с правилом сортировки. Обычно её не следует задавать — тогда эта версия будет получена из фактической версии правила сортировки, сообщённой операционной системой. Это указание предназначено для того, чтобы команда
pg_upgrade
смогла скопировать версию из существующей инсталляции.Что делать при несовпадении версий правил сортировки, описано в ALTER COLLATION.
существующее_правило
Имя копируемого существующего правила сортировки. Новое правило сортировки получит те же свойства, что и существующее, но будет независимым объектом.
Примечания
Команда CREATE COLLATION
устанавливает блокировку SHARE ROW EXCLUSIVE
в системном каталоге pg_collation
. Эта блокировка конфликтует с такой же, поэтому в один момент времени может выполняться только одна команда CREATE COLLATION
.
Для удаления созданных пользователем правил сортировки применяется команда DROP COLLATION
.
Подробнее узнать о создании правил сортировки можно в Подразделе 22.2.2.3.
Когда используется провайдер libc
, локаль должна быть применимой к кодировке текущей базы данных. Точные правила описаны в CREATE DATABASE.
Примеры
Создание правила сортировки из локали операционной системы ru_RU.utf8
(предполагается, что кодировка текущей базы данных — UTF-8
):
CREATE COLLATION russian (locale = 'ru_RU.utf8');
Создание правила сортировки с порядком, при котором латинские буквы идут перед буквами кириллицы, с использованием провайдера ICU:
CREATE COLLATION latn_cyrl (provider = icu, locale = 'ru-RU-u-kr-latn-cyrl');
Создание правила сортировки с пользовательскими условиями с использованием провайдера ICU на основе корневой локали ICU:
CREATE COLLATION custom (provider = icu, locale = 'und', rules = '&V << w <<< W');
За дополнительной информацией и примерами синтаксиса правил обратитесь к Подразделу 22.2.3.4.
Создание правила сортировки из уже существующего:
CREATE COLLATION german FROM "de_DE";
Иногда удобно использовать в приложениях имена правил сортировки, не зависящие от операционной системы.
Совместимость
Оператор CREATE COLLATION
определён в стандарте SQL, но его действие ограничено копированием существующего правила сортировки. Синтаксис создания нового правила сортировки представляет собой расширение Postgres Pro.