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

ALTER TYPE

ALTER TYPE — 更改类型的定义

Synopsis

ALTER TYPE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER }
ALTER TYPE name RENAME TO new_name
ALTER TYPE name SET SCHEMA new_schema
ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name [ CASCADE | RESTRICT ]
ALTER TYPE name action [, ... ]
ALTER TYPE name ADD VALUE [ IF NOT EXISTS ] new_enum_value [ { BEFORE | AFTER } neighbor_enum_value ]
ALTER TYPE name RENAME VALUE existing_enum_value TO new_enum_value
ALTER TYPE name SET ( property = value [, ... ] )

其中action为以下之一:

    ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ]
    DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ]
    ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ]

描述

ALTER TYPE更改现有类型的定义。有几种子形式:

OWNER

这种形式更改类型的拥有者。

RENAME

这种形式更改类型的名称。

SET SCHEMA

这种形式将类型移动到另一个模式中。

RENAME ATTRIBUTE

这种形式只能用于复合类型。 它会更改该类型某个属性的名称。

ADD ATTRIBUTE

该形式使用与CREATE TYPE相同的语法向复合类型添加新属性。

DROP ATTRIBUTE [ IF EXISTS ]

这种形式从复合类型中删除一个属性。 如果指定了IF EXISTS而该属性不存在,则不会抛出错误, 而是发出一条提示。

ALTER ATTRIBUTE ... SET DATA TYPE

这种形式更改复合类型中某个属性的数据类型。

ADD VALUE [ IF NOT EXISTS ] [ BEFORE | AFTER ]

这种形式向枚举类型中添加一个新值。可以用 BEFOREAFTER 指定该新值在枚举排序中的位置,即位于某个现有值之前或之后。 否则,新项会被添加到值列表的末尾。

如果指定了 IF NOT EXISTS,而该类型已经包含该新值, 则不会报错:系统会发出一条提示,但不会执行任何其他操作。 否则,如果该新值已存在,就会报错。

RENAME VALUE

这种形式重命名枚举类型中的一个值。 该值在枚举排序中的位置不会受到影响。 如果指定的值不存在,或者新名称已经存在,则会报错。

SET ( property = value [, ... ] )

该形式仅适用于基础类型。它允许调整基础类型的一部分属性,这些属性可以在CREATE TYPE中设置。具体而言,可以更改以下属性:

  • 可以将RECEIVE设置为二进制输入函数的名称, 或者设置为NONE以移除该类型的二进制输入函数。 使用此选项需要超级用户权限。

  • 可以将SEND设置为二进制输出函数的名称, 或者设置为NONE以移除该类型的二进制输出函数。 使用此选项需要超级用户权限。

  • 可以将TYPMOD_IN设置为类型修饰符输入函数的名称, 或者设置为NONE以移除该类型的类型修饰符输入函数。 使用此选项需要超级用户权限。

  • 可以将TYPMOD_OUT设置为类型修饰符输出函数的名称, 或者设置为NONE以移除该类型的类型修饰符输出函数。 使用此选项需要超级用户权限。

  • 可以将ANALYZE设置为类型专用的统计信息收集函数的名称, 或者设置为NONE以移除该类型的统计信息收集函数。 使用此选项需要超级用户权限。

  • 可以将STORAGE设置为plainextendedexternal、 或 main(关于这些设置含义的更多信息,见 Section 69.2)。 但是,从plain改为其他设置需要超级用户权限 (因为这要求该类型的 C 函数全部都能处理 TOAST),而从其他设置改为 plain则完全不允许(因为数据库中可能已经存在该类型经过 TOAST 处理的值)。请注意,更改该选项本身不会改变任何已存储的数据, 它只是为将来创建的表列设置默认的 TOAST 策略。 要更改现有表列的 TOAST 策略,请参见 ALTER TABLE

参见CREATE TYPE,了解有关这些类型属性的更多详情。请注意,在适用情况下,基础类型的这些属性发生更改后,会自动传播到基于该类型的域。

ADD ATTRIBUTEDROP ATTRIBUTEALTER ATTRIBUTE 操作 可以组合成一个包含多项修改的列表,以便并行应用。 例如,可以在一条命令中添加多个属性和/或更改多个属性的数据类型。

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

参数

name

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

new_name

该类型的新名称。

new_owner

该类型新的拥有者的用户名。

new_schema

该类型的新模式。

attribute_name

要添加、修改或删除的属性名称。

new_attribute_name

要重命名的属性的新名称。

data_type

要添加的属性的数据类型,或者要修改的属性的新类型。

new_enum_value

要添加到枚举类型值列表中的新值,或者要赋给现有值的新名称。 与所有枚举字面量一样,它必须加引号。

neighbor_enum_value

一个现有枚举值;在枚举类型的排序顺序中,新值会紧邻该值, 被添加到它之前或之后。与所有枚举字面量一样,它必须加引号。

existing_enum_value

应当被重命名的现有枚举值。与所有枚举字面量一样,它必须加引号。

property

要修改的基础类型属性名称;可能的取值见上文。

CASCADE

自动将该操作传播到正在修改的类型的类型化表及其后代。

RESTRICT

如果正在修改的类型是某个类型化表的类型,则拒绝该操作。 这是默认行为。

注解

如果在事务块中执行 ALTER TYPE ... ADD VALUE (即向枚举类型添加新值的形式),则在事务提交之后才能使用该新值。

涉及新增枚举值的比较有时会比仅涉及该枚举类型原有成员的比较更慢。 这通常只会在使用 BEFOREAFTER 将新值的排序位置设在列表末尾之外时发生。不过,即使新值被添加到末尾, 有时也会出现这种情况(如果自最初创建该枚举类型以来 OID 计数器已经 回卷,就会发生这种情况)。这种变慢通常无关紧要;但如果它确实 重要,可以通过删除并重新创建该枚举类型,或者转储并恢复数据库,来恢复最佳性能。

示例

要重命名一个数据类型:

ALTER TYPE electronic_mail RENAME TO email;

要将类型email的拥有者改为 joe

ALTER TYPE email OWNER TO joe;

要将类型email所在的模式改为 customers

ALTER TYPE email SET SCHEMA customers;

要向一个复合类型添加一个新属性:

ALTER TYPE compfoo ADD ATTRIBUTE f3 int;

要在枚举类型的特定排序位置添加一个新值:

ALTER TYPE colors ADD VALUE 'orange' AFTER 'red';

重命名枚举值:

ALTER TYPE colors RENAME VALUE 'purple' TO 'mauve';

要为现有基础类型创建二进制 I/O 函数:

CREATE FUNCTION mytypesend(mytype) RETURNS bytea ...;
CREATE FUNCTION mytyperecv(internal, oid, integer) RETURNS mytype ...;
ALTER TYPE mytype SET (
    SEND = mytypesend,
    RECEIVE = mytyperecv
);

兼容性

添加和删除属性的这些变体属于 SQL 标准;其他变体则是 PostgreSQL 扩展。