ALTER DOMAIN
ALTER DOMAIN — 更改一个域的定义
大纲
ALTER DOMAINname{ SET DEFAULTexpression| DROP DEFAULT } ALTER DOMAINname{ SET | DROP } NOT NULL ALTER DOMAINnameADDdomain_constraint[ NOT VALID ] ALTER DOMAINnameDROP CONSTRAINT [ IF EXISTS ]constraint_name[ RESTRICT | CASCADE ] ALTER DOMAINnameRENAME CONSTRAINTconstraint_nameTOnew_constraint_nameALTER DOMAINnameVALIDATE CONSTRAINTconstraint_nameALTER DOMAINnameOWNER TO {new_owner| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER DOMAINnameRENAME TOnew_nameALTER DOMAINnameSET SCHEMAnew_schema其中domain_constraint是: [ CONSTRAINTconstraint_name] { NOT NULL | CHECK (expression) }
描述
ALTER DOMAIN 更改一个现有域的定义。有以下几种子形式:
SET/DROP DEFAULT#这些形式为域设置或移除默认值。注意,默认值只适用于后续的
INSERT命令;它们不会影响已存在于使用该域的表中的行。SET/DROP NOT NULL#这些形式更改域是被标记为允许 NULL 值还是拒绝 NULL 值。只有当使用该域的列中不包含空值时,才能执行
SET NOT NULL。ADD#domain_constraint[ 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 权限。(这些限制确保更改拥有者不会做出任何你不能通过删除并重新创建该域来完成的事情。不过,超级用户无论如何都可以更改任何域的所有权。)
参数
name#要修改的现有域的名称(可以是模式限定的)。
domain_constraint#该域的新约束。
constraint_name#要删除或重命名的现有约束名称。
NOT VALID#不验证现有存储的数据是否满足该约束。
CASCADE#自动删除依赖于该约束的对象,以及进一步依赖于这些对象的所有对象(见第 5.16 节)。
RESTRICT#如果存在任何依赖对象,则拒绝删除该约束。这是默认行为。
new_name#域的新名称。
new_constraint_name#约束的新名称。
new_owner#域的新拥有者的用户名。
new_schema#域的新模式。
注解
尽管 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
这些变体是 PostgreSQL 扩展;ADD CONSTRAINT 变体中的 NOT VALID 子句也是 PostgreSQL 扩展。