CREATE DOMAIN
Синтаксис
CREATE DOMAIN имя [ AS ] тип_данных
[ COLLATE правило_сортировки ]
[ DEFAULT выражение ]
[ ограничение [ ... ] ]
Здесь ограничение:
[ CONSTRAINT имя_ограничения ]
{ NOT NULL | NULL | CHECK (выражение) }Описание
CREATE DOMAIN создаёт новый домен. Домен по сути представляет собой тип данных с дополнительными условиями (ограничивающими допустимый набор значений). Владельцем домена становится пользователь его создавший.
Если задаётся имя схемы (например, CREATE DOMAIN myschema.mydomain ...), домен создаётся в указанной схеме, в противном случае — в текущей. Имя домена должно быть уникальным среди имён типов и доменов, существующих в этой схеме.
Домены полезны для абстрагирования и вынесения общих характеристик разных полей в единое место для упрощения сопровождения. Например, в нескольких таблицах может присутствовать колонка, содержащая электронный адрес, и для всех требуются одинаковые ограничения CHECK, проверяющие синтаксис адреса. В этом случае лучше определить домен, а не задавать для каждой таблицы отдельные ограничения.
Чтобы создать домен, необходимо иметь право USAGE для нижележащего типа.
Параметры
- имя
Имя (возможно, дополненное схемой) создаваемого домена.
- тип_данных
Нижележащий тип данных домена (может включать определение массива с этим типом).
- правило_сортировки
Необязательное указание правила сортировки для домена. Если это указание отсутствует, используется правило сортировки по умолчанию нижележащего типа данных. Указать COLLATE можно, только если нижележащий тип данных является сортируемым.
- DEFAULT выражение
Предложение DEFAULT определяет значение по умолчанию для колонок, типом данных которых является этот домен. Значением может быть любое выражение без переменных (подзапросы также не допускаются). Тип данных этого выражения должен соответствовать типу данных домена. Если значение по умолчанию не указано, им будет значение NULL.
Значение по умолчанию будет использоваться в любой операции добавления строк, в которой не задано значение для этой колонки. Если значение по умолчанию установлено для конкретной колонки, оно будет переопределять значение по умолчанию, связанное с доменом. В свою очередь, значение по умолчанию для домена переопределяет любое значение по умолчанию, связанное с нижележащим типом данных.
- CONSTRAINT имя_ограничения
Имя ограничения. Если не указано явно, имя будет сгенерировано системой.
- NOT NULL
Такой домен как правило не принимает значения NULL. Однако домен с таким ограничением всё же может принимать значение NULL, если ему присваивается такой же тип домена, который оказался равным NULL, например, в результате LEFT OUTER JOIN или INSERT INTO tab (domcol) VALUES ((SELECT domcol FROM tab WHERE false)).
- NULL
Этот домен может содержать значение NULL. Это свойство домена по умолчанию.
Это предложение предназначено только для совместимости с нестандартными базами данных SQL. Использовать его в новых приложениях не рекомендуется.
- CHECK (выражение)
Предложения CHECK задают ограничения целостности или проверки, которым должны удовлетворять значения домена. Каждое ограничение должно представлять собой выражение, выдающее результат типа Boolean. Проверяемое значение в этом выражении обозначается ключевым словом VALUE.
В настоящее время выражения CHECK не могут содержать переменные, кроме VALUE, и подзапросы.
Примеры
В этом примере создаётся тип данных us_postal_code (почтовый индекс США), который затем используется в определении таблицы. Для проверки значения на соответствие формату почтовых индексов США применяется проверка с регулярными выражениями:
CREATE DOMAIN us_postal_code AS TEXT
CHECK(
VALUE ~ '^\d{5}$'
OR VALUE ~ '^\d{5}-\d{4}$'
);
CREATE TABLE us_snail_addy (
address_id SERIAL PRIMARY KEY,
street1 TEXT NOT NULL,
street2 TEXT,
street3 TEXT,
city TEXT NOT NULL,
postal us_postal_code NOT NULL
);| Пред. | Начало | След. |
| CREATE DATABASE | Уровень выше | CREATE EVENT TRIGGER |