ALTER TYPE

Description

Alters the definition of a type.

Precautions

Only the type owner or a user granted with the ALTER permission can run the ALTER TYPE command. System administrators have this permission by default. To modify the owner or schema of a type, you must be a type owner or system administrator and a member of the new owner role.

Syntax

Modify a type.

ALTER TYPE name action [, ... ];

The clauses corresponding to action are as follows:

Add a new attribute to a composite type.

        
             ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ]

Drop an attribute from a composite type.

        
             DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ]

Alter the type of an attribute in a composite type.

        
             ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ]

Add a new attribute to a composite type.

ALTER TYPE name ADD ATTRIBUTE attribute_name data_type [ COLLATE collation ] [ CASCADE | RESTRICT ];

Drop an attribute from a composite type.

ALTER TYPE name DROP ATTRIBUTE [ IF EXISTS ] attribute_name [ CASCADE | RESTRICT ];

Alter the type of an attribute in a composite type.

ALTER TYPE name ALTER ATTRIBUTE attribute_name [ SET DATA ] TYPE data_type [ COLLATE collation ] [ CASCADE | RESTRICT ];

Alter the owner of a type.

ALTER TYPE name OWNER TO { new_owner | CURRENT_USER | SESSION_USER };

Alter the name of a type.
```
ALTER TYPE name RENAME TO new_name;
```

Alter the name of an attribute in a composite type.

ALTER TYPE name RENAME ATTRIBUTE attribute_name TO new_attribute_name [ CASCADE | RESTRICT ];

Move a type to a new schema.
```
ALTER TYPE name SET SCHEMA new_schema;
```

Add a new value to an enumerated type.

ALTER TYPE name ADD VALUE [ IF NOT EXISTS ] new_enum_value [ { BEFORE | AFTER } neighbor_enum_value ];

Alter an enumerated value in the value list.

ALTER TYPE name RENAME VALUE existing_enum_value TO new_enum_value;

Parameters

name
Specifies the name of an existing type that needs to be modified (optionally schema-qualified).

new_name
Specifies the new name of the type.

new_owner
Specifies the new owner of the type.

new_schema
Specifies the new schema of the type.

attribute_name
Specifies the name of the attribute to be added, modified, or deleted.

new_attribute_name
Specifies the new name of the attribute to be renamed.

data_type
Specifies the data type of the attribute to be added, or the new type of the attribute to be modified.
new_enum_value
Specifies a new enumerated value. It is a non-null string with a maximum length of 63 bytes.
neighbor_enum_value
Specifies an existing enumerated value before or after which a new enumerated value will be added.
existing_enum_value
Specifies an enumerated value to be changed. It is a non-null string with a maximum length of 63 bytes.

CASCADE
Determines that the type to be modified, its associated records, and subtables that inherit the type will all be updated.
RESTRICT
Refuses to update the associated records of the modified type. This is the default action.
- ADD ATTRIBUTE, DROP ATTRIBUTE, and ALTER ATTRIBUTE can be combined for processing. For example, it is possible to add several attributes or change the types of several attributes at the same time in one command.
- To change a schema of a type, you must have the CREATE permission on the new schema. To change the owner, you must be a direct or indirect member of the new owning role, and the member must have the CREATE permission on the schema of this type. (These restrictions enforce that the user can only rebuild and drop the type. However, system administrators can change ownership of any type in any way.) To add an attribute or change the type of an attribute, you must also have the USAGE permission of this type.