↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译，由 Pigsty 团队维护。

百科 / SQL 命令 / 类型与运算符

SQL COMMAND · 类型与运算符

ALTER DOMAIN

更改一个域的定义

ALTER类型与运算符引入 10（基线）现存至 20 devel2 次语法变更

动词
ALTER
对象
DOMAIN
引入版本
10（基线）
状态
现存
语法变更次数
2
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读，分岔表示选择，绕行表示可选，回环表示重复。方框为参数，点击带下划线的参数可展开子规则。

ALTER DOMAIN name SET DEFAULT expression DROP DEFAULT
ALTER DOMAIN · 语法 2
ALTER DOMAIN name SET DROP NOT NULL
ALTER DOMAIN · 语法 3
ALTER DOMAIN name ADD domain_constraint NOT VALID
ALTER DOMAIN · 语法 4
ALTER DOMAIN name DROP CONSTRAINT IF EXISTS constraint_name RESTRICT CASCADE
ALTER DOMAIN · 语法 5
ALTER DOMAIN name RENAME CONSTRAINT constraint_name TO new_constraint_name
ALTER DOMAIN · 语法 6
ALTER DOMAIN name VALIDATE CONSTRAINT constraint_name
ALTER DOMAIN · 语法 7
ALTER DOMAIN name OWNER TO new_owner CURRENT_ROLE CURRENT_USER SESSION_USER
ALTER DOMAIN · 语法 8
ALTER DOMAIN name RENAME TO new_name
ALTER DOMAIN · 语法 9
ALTER DOMAIN name SET SCHEMA new_schema
domain_constraint
CONSTRAINT constraint_name NOT NULL CHECK ( expression )

语法概要

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

PostgreSQL 18 手册 · 查看完整参考页

描述

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

语法演化

相邻大版本之间的差异，新的在前。版本号链接到对应快照。

  1. PostgreSQL 19← 18正文更新

    正文更新

  2. PostgreSQL 17← 16正文更新

    正文更新

  3. PostgreSQL 16← 15正文更新

    正文更新

  4. PostgreSQL 14← 13语法变化

    + OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }

  5. PostgreSQL 12← 11语法变化

    + [ CONSTRAINT constraint_name ]+ { NOT NULL | CHECK (expression) }正文更新

  6. PostgreSQL 11← 10正文更新

    正文更新

同组命令

命令动词对象版本变动最近变更
TYPES & OPERATORS类型与运算符23 条↑
CREATE CASTCREATECAST —
定义一种新的类型转换现存
DROP CASTDROPCAST —
移除一个类型转换现存
CREATE COLLATIONCREATECOLLATION 162 次
定义一种新排序规则现存
ALTER COLLATIONALTERCOLLATION 141 次
更改排序规则的定义现存
DROP COLLATIONDROPCOLLATION —
删除一个排序规则现存
CREATE CONVERSIONCREATECONVERSION —
定义一个新的编码转换现存
ALTER CONVERSIONALTERCONVERSION 141 次
更改一个转换的定义现存
DROP CONVERSIONDROPCONVERSION —
移除一个转换现存
CREATE DOMAINCREATEDOMAIN 171 次
定义一个新域现存
ALTER DOMAINALTERDOMAIN 142 次
更改一个域的定义现存
DROP DOMAINDROPDOMAIN —
移除一个域现存
CREATE OPERATORCREATEOPERATOR 192 次
定义一个新的操作符现存
ALTER OPERATORALTEROPERATOR 172 次
更改一个操作符的定义现存
DROP OPERATORDROPOPERATOR 141 次
移除一个操作符现存
CREATE OPERATOR CLASSCREATEOPERATOR CLASS —
定义一个新的操作符类现存
ALTER OPERATOR CLASSALTEROPERATOR CLASS 141 次
更改一个操作符类的定义现存
DROP OPERATOR CLASSDROPOPERATOR CLASS —
移除一个操作符类现存
CREATE OPERATOR FAMILYCREATEOPERATOR FAMILY —
定义一个新的操作符族现存
ALTER OPERATOR FAMILYALTEROPERATOR FAMILY 141 次
更改一个操作符族的定义现存
DROP OPERATOR FAMILYDROPOPERATOR FAMILY —
移除一个操作符族现存
CREATE TYPECREATETYPE 141 次
定义一种新数据类型现存
ALTER TYPEALTERTYPE 142 次
更改类型的定义现存
DROP TYPEDROPTYPE —
移除一个数据类型现存