ALTER DOMAIN

ALTER DOMAIN
上一页	上一级	SQL 命令	首页	下一页

ALTER DOMAIN — 更改一个域的定义

Synopsis

ALTER DOMAIN name
    { SET DEFAULT expression | DROP DEFAULT }
ALTER DOMAIN name
    { SET | DROP } NOT NULL
ALTER DOMAIN name
    ADD domain_constraint [ NOT VALID ]
ALTER DOMAIN name
    DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ]
ALTER DOMAIN name
     RENAME CONSTRAINT constraint_name TO new_constraint_name
ALTER DOMAIN name
    VALIDATE CONSTRAINT constraint_name
ALTER DOMAIN name
    OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER DOMAIN name
    RENAME TO new_name
ALTER DOMAIN name
    SET SCHEMA new_schema

where domain_constraint is:

[ CONSTRAINT constraint_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: 自动删除依赖于该约束的对象，并进而删除依赖于那些对象的所有对象（参见 Section 5.15）。
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 的一个扩展。

另请参阅

CREATE DOMAIN, DROP DOMAIN