ALTER DOMAIN

更改一个域的定义

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

7.4 8.0 8.1 8.2 8.3 8.4 9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19 20

anchor: SQL-ALTERDOMAIN
file: sql-alterdomain.html
lang: en
name: ALTER DOMAIN
purpose: change the definition of a domain
purpose zh: 未知
sections same as: 未知
slug: 18

语法

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 · 语法 2

ALTER DOMAIN · 语法 3

ALTER DOMAIN · 语法 4

ALTER DOMAIN · 语法 5

ALTER DOMAIN · 语法 6

ALTER DOMAIN · 语法 7

ALTER DOMAIN · 语法 8

ALTER DOMAIN · 语法 9

domain_constraint

版本定义 PG 18

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
其中 domain_constraint 是：

[ 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: 自动删除依赖于该约束的对象，以及进一步依赖于这些对象的所有对象（见第 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

比较版本

完整来源事实

synopsis html

ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    { SET DEFAULT <em class="replaceable"><code>expression</code></em> | DROP DEFAULT }
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    { SET | DROP } NOT NULL
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    ADD <em class="replaceable"><code>domain_constraint</code></em> [ NOT VALID ]
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    DROP CONSTRAINT [ IF EXISTS ] <em class="replaceable"><code>constraint_name</code></em> [ RESTRICT | CASCADE ]
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
     RENAME CONSTRAINT <em class="replaceable"><code>constraint_name</code></em> TO <em class="replaceable"><code>new_constraint_name</code></em>
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    VALIDATE CONSTRAINT <em class="replaceable"><code>constraint_name</code></em>
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    OWNER TO { <em class="replaceable"><code>new_owner</code></em> | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    RENAME TO <em class="replaceable"><code>new_name</code></em>
ALTER DOMAIN <em class="replaceable"><code>name</code></em>
    SET SCHEMA <em class="replaceable"><code>new_schema</code></em>

<span class="phrase">where <em class="replaceable"><code>domain_constraint</code></em> is:</span>

[ CONSTRAINT <em class="replaceable"><code>constraint_name</code></em> ]
{ NOT NULL | CHECK (<em class="replaceable"><code>expression</code></em>) }

synopsis text

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) }

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c