选择 打开 改范围 完整检索页
受支持版本: 当前版本 (18) / 17 / 16 / 15 / 14
开发版本: 19 / devel
不受支持的版本: 13 / 12 / 11 / 10
当前 PostgreSQL 版本不在支持生命周期内。
您可以参阅当前版本的对应页面,或其他在上面列出的活跃大版本。

ALTER DOMAIN

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_USER | SESSION_USER }
ALTER DOMAIN name
    RENAME TO new_name
ALTER DOMAIN name
    SET SCHEMA new_schema

描述

ALTER DOMAIN更改一个现有域的定义。有以下几种子形式:

SET/DROP DEFAULT

这些形式为域设置或移除默认值。注意,默认值只适用于后续的 INSERT命令;它们不会影响已存在于使用该域的表中的行。

SET/DROP NOT NULL

这些形式更改域是被标记为允许 NULL 值还是拒绝 NULL 值。只有当使用该域的列中 不包含空值时,才能执行SET NOT NULL

ADD domain_constraint [ NOT VALID ]

此形式使用与CREATE DOMAIN相同的语法向域添加新约束。向域添加新约束时,所有使用该域的列都会根据新添加的约束进行检查。可以使用NOT VALID选项添加新约束来抑制这些检查;之后可以使用ALTER DOMAIN ... VALIDATE CONSTRAINT验证该约束。新插入或更新的行始终根据所有约束进行检查,即使这些约束标记为NOT VALIDNOT VALID只能用于CHECK约束。

DROP CONSTRAINT [ IF EXISTS ]

这种形式删除域上的约束。如果指定了IF EXISTS而该约束不存在, 则不会抛出错误,而是发出一条提示。

RENAME CONSTRAINT

这种形式更改域上某个约束的名称。

VALIDATE CONSTRAINT

这种形式验证一个先前以NOT VALID方式添加的约束,也就是说, 它会核实该域类型的表列中的所有值都满足指定约束。

OWNER

这种形式将域的拥有者更改为指定用户。

RENAME

这种形式更改域的名称。

SET SCHEMA

这种形式更改域所在的模式。与该域关联的任何约束也会一并移动到新模式中。

要使用ALTER DOMAIN,必须拥有该域。要更改域的模式,还必须在新模式上拥有CREATE权限。要更改所有者,还必须是新所有者角色的直接或间接成员,并且该角色必须在域所在模式上拥有CREATE权限。(这些限制确保更改所有者不会执行任何无法通过删除并重新创建域完成的操作。不过,超级用户无论如何都可以更改任何域的所有权。)

参数

name

要修改的现有域的名称(可以是模式限定的)。

domain_constraint

该域的新约束。

constraint_name

要删除或重命名的现有约束名称。

NOT VALID

不验证现有存储的数据是否满足该约束。

CASCADE

自动删除依赖于该约束的对象,以及进一步依赖于这些对象的所有对象 (见Section 5.13)。

RESTRICT

如果存在任何依赖对象,则拒绝删除该约束。这是默认行为。

new_name

域的新名称。

new_constraint_name

约束的新名称。

new_owner

域的新拥有者的用户名。

new_schema

域的新模式。

注解

尽管ALTER DOMAIN ADD CONSTRAINT会尝试验证现有存储的数据 是否满足新约束,但这种检查并非万无一失,因为该命令无法看到那些 新插入或已更新但尚未提交的表行。如果存在并发操作可能插入不符合约束的数据的风险, 正确做法是使用NOT VALID选项添加该约束,提交该命令,等待所有在此次 提交之前启动的事务结束,然后发出ALTER DOMAIN VALIDATE CONSTRAINT来查找违反该约束的数据。这种方法是可靠的,因为一旦该约束被 提交,所有新事务都保证会对域类型的新值强制执行该约束。

目前,如果要验证的命名域或任何派生域被数据库中任意表的复合类型列使用,ALTER DOMAIN ADD CONSTRAINTALTER DOMAIN VALIDATE CONSTRAINTALTER 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标准,但 OWNERRENAMESET SCHEMAVALIDATE CONSTRAINT 这些变体是PostgreSQL扩展; ADD CONSTRAINT变体中的NOT VALID子句也 是PostgreSQL扩展。