SQL COMMAND · 类型与运算符

ALTER DOMAIN

更改一个域的定义

change the definition of a domain

ALTER类型与运算符引入 7.4现存至 20 devel5 次语法变更

动词: ALTER
对象: DOMAIN
分组: 类型与运算符
引入版本: 7.4
状态: 现存
语法变更次数: 5
手册小节数: 6

本站手册 · 18 官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

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

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

语法概要

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

语法演化

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

PostgreSQL 19← 18正文更新

正文更新
PostgreSQL 17← 16正文更新

正文更新
PostgreSQL 16← 15正文更新

正文更新
PostgreSQL 14← 13语法变化

+ OWNER TO { new_owner | CURRENT_ROLE | CURRENT_USER | SESSION_USER }
PostgreSQL 12← 11语法变化

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

正文更新
PostgreSQL 10← 9.6正文更新

正文更新
PostgreSQL 9.6← 9.5正文更新

正文更新
PostgreSQL 9.5← 9.4语法变化

+ OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
PostgreSQL 9.4← 9.3正文更新

正文更新
PostgreSQL 9.2← 9.1语法变化

+ ADD domain_constraint [ NOT VALID ]+ DROP CONSTRAINT [ IF EXISTS ] constraint_name [ RESTRICT | CASCADE ]+ RENAME CONSTRAINT constraint_name TO new_constraint_name+ ALTER DOMAIN name+ VALIDATE CONSTRAINT constraint_name+ ALTER DOMAIN name+ RENAME TO new_name+ ALTER DOMAIN name正文更新
PostgreSQL 8.3← 8.2正文更新

正文更新
PostgreSQL 8.2← 8.1正文更新

正文更新
PostgreSQL 8.1← 8.0语法变化

+ ALTER DOMAIN name+ SET SCHEMA new_schema正文更新
PostgreSQL 8.0← 7.4正文更新

正文更新
PostgreSQL 7.4← 7.3新增此命令

同组命令

命令	动词	对象	最近变更
TYPES & OPERATORS类型与运算符23 条↑
`CREATE CAST`	CREATE	CAST	104 次
定义一种新的类型转换			现存
`DROP CAST`	DROP	CAST	9.02 次
移除一个类型转换			现存
`CREATE COLLATION`	CREATE	COLLATION	163 次
定义一种新排序规则			现存
`ALTER COLLATION`	ALTER	COLLATION	143 次
更改排序规则的定义			现存
`DROP COLLATION`	DROP	COLLATION	—
删除一个排序规则			现存
`CREATE CONVERSION`	CREATE	CONVERSION	9.02 次
定义一个新的编码转换			现存
`ALTER CONVERSION`	ALTER	CONVERSION	145 次
更改一个转换的定义			现存
`DROP CONVERSION`	DROP	CONVERSION	8.22 次
移除一个转换			现存
`CREATE DOMAIN`	CREATE	DOMAIN	174 次
定义一个新域			现存
`ALTER DOMAIN`	ALTER	DOMAIN	145 次
更改一个域的定义			现存
`DROP DOMAIN`	DROP	DOMAIN	8.22 次
移除一个域			现存
`CREATE OPERATOR`	CREATE	OPERATOR	198 次
定义一个新的操作符			现存
`ALTER OPERATOR`	ALTER	OPERATOR	176 次
更改一个操作符的定义			现存
`DROP OPERATOR`	DROP	OPERATOR	148 次
移除一个操作符			现存
`CREATE OPERATOR CLASS`	CREATE	OPERATOR CLASS	9.15 次
定义一个新的操作符类			现存
`ALTER OPERATOR CLASS`	ALTER	OPERATOR CLASS	145 次
更改一个操作符类的定义			现存
`DROP OPERATOR CLASS`	DROP	OPERATOR CLASS	8.22 次
移除一个操作符类			现存
`CREATE OPERATOR FAMILY`	CREATE	OPERATOR FAMILY	—
定义一个新的操作符族			现存
`ALTER OPERATOR FAMILY`	ALTER	OPERATOR FAMILY	146 次
更改一个操作符族的定义			现存
`DROP OPERATOR FAMILY`	DROP	OPERATOR FAMILY	—
移除一个操作符族			现存
`CREATE TYPE`	CREATE	TYPE	1413 次
定义一种新数据类型			现存
`ALTER TYPE`	ALTER	TYPE	148 次
更改类型的定义			现存
`DROP TYPE`	DROP	TYPE	8.24 次
移除一个数据类型			现存

快速链接

版本轨迹

语法铁道图 PostgreSQL 18

语法概要

描述

参数

注解

示例

兼容性

另见

语法演化

相关命令

同组命令