支持的版本: 当前 (17) / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0

ALTER TYPE

ALTER TYPE — 更改类型的定义

概要

ALTER TYPE name OWNER TO { new_owner | CURRENT_ROLE | 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 [, ... ] )

where action is one of:

    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 以删除类型的统计信息收集函数。使用此选项需要超级用户权限。

  • SUBSCRIPT 可以设置为特定类型的下标处理函数的名称,或者设置为 NONE 以删除类型的下标处理函数。使用此选项需要超级用户权限。

  • STORAGE 可以设置为 plainextendedexternalmain(有关这些含义的更多信息,请参阅第 65.2 节)。但是,从 plain 更改为其他设置需要超级用户权限(因为它要求类型的所有 C 函数都必须是 TOAST 就绪的),并且完全不允许从其他设置更改为 plain(因为类型可能已经在数据库中存在 TOAST 值)。请注意,更改此选项本身不会更改任何存储的数据,它只是设置将来创建的表列的默认 TOAST 策略。有关更改现有表列的 TOAST 策略,请参阅ALTER TABLE

有关这些类型属性的更多详细信息,请参阅CREATE TYPE。请注意,在适当的情况下,基本类型的这些属性的更改将自动传播到基于该类型的域。

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

您必须拥有该类型才能使用 ALTER TYPE。要更改类型的模式,您还必须在新模式上具有 CREATE 权限。要更改所有者,您必须能够 SET ROLE 为新的所有者角色,并且该角色必须在类型的模式上具有 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 扩展。

另请参阅

CREATE TYPE, DROP TYPE

提交更正

如果您发现文档中的任何内容不正确、与您对特定功能的体验不符或需要进一步澄清,请使用此表单报告文档问题。