ALTER DOMAIN
ALTER DOMAIN — изменить определение домена
Синтаксис
ALTER DOMAINимя{ SET DEFAULTвыражение| DROP DEFAULT } ALTER DOMAINимя{ SET | DROP } NOT NULL ALTER DOMAINимяADDограничение_домена[ NOT VALID ] ALTER DOMAINимяDROP CONSTRAINT [ IF EXISTS ]имя_ограничения[ RESTRICT | CASCADE ] ALTER DOMAINимяRENAME CONSTRAINTимя_ограниченияTOимя_нового_ограниченияALTER DOMAINимяVALIDATE CONSTRAINTимя_ограниченияALTER DOMAINимяOWNER TO {новый_владелец| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER DOMAINимяRENAME TOновое_имяALTER DOMAINимяSET SCHEMAновая_схемаЗдесьограничение_домена: [ CONSTRAINTимя_ограничения] { NOT NULL | CHECK (выражение) }
Описание
ALTER DOMAIN изменяет определение существующего домена. Эта команда имеет несколько разновидностей:
SET/DROP DEFAULTЭти формы задают/убирают значение по умолчанию для домена. Заметьте, что эти значения по умолчанию применяются только при последующих командах
INSERT; они не меняются в строках с данным доменом, уже добавленных в таблицу.SET/DROP NOT NULLЭти формы определяют, будет ли домен принимать значения NULL или нет.
SET NOT NULLможно выполнить, только если столбцы с этим доменом ещё не содержат значений NULL.ADDограничение_домена[ NOT VALID ]Эта форма добавляет новое ограничение для домена. Когда добавляется новое ограничение домена, все столбцы с этим доменом будут проверены на соответствие этому ограничению. Эти проверки можно подавить, добавив указание
NOT VALID, а затем активировать позднее с помощью командыALTER DOMAIN ... VALIDATE CONSTRAINT. Вновь вставленные или изменённые строки всегда проверяются по всем ограничениям, даже тем, что отмечены какNOT VALID. УказаниеNOT VALIDдопускается только для ограниченийCHECK.DROP CONSTRAINT [ IF EXISTS ]Эта форма убирает ограничения домена. Если указано
IF EXISTSи заданное ограничение не существует, это не считается ошибкой. В этом случае выдаётся только замечание.RENAME CONSTRAINTЭта форма меняет название ограничения домена.
VALIDATE CONSTRAINTЭта форма включает проверку ограничения, ранее добавленного как
NOT VALID, то есть проверяет все значения в столбцах с этим типом домена на соответствие этому ограничению.OWNERЭта форма меняет владельца домена на заданного пользователя.
RENAMEЭта форма меняет название домена.
SET SCHEMAЭта форма меняет схему домена. Все ограничения, связанные с данным доменом, так же переносятся в новую схему.
Выполнить ALTER DOMAIN может только владелец соответствующего домена. Чтобы сменить схему домена, необходимо также иметь право CREATE в новой схеме. Чтобы сменить владельца, необходимо иметь право SET ROLE для новой роли-владельца, а эта роль должна иметь право CREATE в схеме домена. (С такими ограничениями при смене владельца не происходит ничего такого, что нельзя было бы сделать, имея право удалить и вновь создать домен. Однако суперпользователь может сменить владельца домена в любом случае.)
Параметры
имяИмя существующего домена (возможно, дополненное схемой), подлежащего изменению.
ограничение_доменаНовое ограничение домена.
имя_ограниченияИмя существующего ограничения, подлежащего удалению или переименованию.
NOT VALIDНе проверять существующие сохранённые данные на соответствие ограничению.
CASCADEАвтоматически удалять объекты, зависящие от данного ограничения, и, в свою очередь, все зависящие от них объекты (см. Раздел 5.15).
RESTRICTОтказать в удалении ограничения, если существуют зависящие от него объекты. Это поведение по умолчанию.
новое_имяНовое имя домена.
имя_нового_ограниченияНовое имя ограничения.
новый_владелецИмя пользователя, назначаемого новым владельцем домена.
новая_схемаНовая схема домена.
Примечания
Хотя команда ALTER DOMAIN ADD CONSTRAINT пытается проверить, удовлетворяют ли уже существующие данные новому ограничению, эта проверка не очень надёжна, так как данная команда не «видит» строки таблицы, которые были только что добавлены или изменены, но ещё не зафиксированы. Если есть риск того, что параллельные операции могут вставить неподходящие данные, можно применить следующий подход: создать ограничение с указанием NOT VALID, зафиксировать эту команду, подождать окончания всех транзакций, начатых до фиксирования, а затем выполнить ALTER DOMAIN VALIDATE CONSTRAINT для проведения контроля данных. В этом случае проверка будет надёжной, так как после фиксирования ограничения оно будет гарантированно действовать на все новые значения типа домена, вносимые последующими транзакциями.
В настоящее время команды ALTER DOMAIN ADD CONSTRAINT, ALTER DOMAIN VALIDATE CONSTRAINT и ALTER DOMAIN SET NOT NULL выдают ошибку, если указанный домен или любой производный от него используется в столбце с типом-контейнером (это может быть составной, диапазонный тип или массив) в какой-либо таблице базы данных. В дальнейшем они будут доработаны, с тем чтобы новое ограничение проверялось и при такой вложенности.
Примеры
Добавление ограничения NOT NULL к домену:
ALTER DOMAIN zipcode SET NOT NULL;
Удаление ограничения NOT NULL из домена:
ALTER DOMAIN zipcode DROP NOT NULL;
Добавление ограничения-проверки к домену:
ALTER DOMAIN zipcode ADD CONSTRAINT zipchk CHECK (char_length(VALUE) = 5);
Удаление ограничения-проверки из домена:
ALTER DOMAIN zipcode DROP CONSTRAINT zipchk;
Переименование ограничения-проверки в домене:
ALTER DOMAIN zipcode RENAME CONSTRAINT zipchk TO zip_check;
Перемещение домена в другую схему:
ALTER DOMAIN zipcode SET SCHEMA customers;
Совместимость #
ALTER DOMAIN соответствует стандарту SQL, за исключением подвидов OWNER, RENAME, SET SCHEMA и VALIDATE CONSTRAINT, которые являются расширениями Postgres Pro. Предложение NOT VALID вариации ADD CONSTRAINT также является расширением Postgres Pro.