DROP TYPE
remove a data type
English manual coverage begins with PostgreSQL 6.4. Source history and runtime observations have their own recorded version boundaries.
Reading PG 18·Select a recorded version
- anchor
- SQL-DROPTYPE
- file
- sql-droptype.html
- lang
- en
- name
- DROP TYPE
- purpose
- remove a data type
- purpose zh
- 移除一个数据类型
- sections same as
- Unknown
- slug
- 18
- synopsis html
- DROP TYPE [ IF EXISTS ] <em class="replaceable"><code>name</code></em> [, ...] [ CASCADE | RESTRICT ]
- synopsis text
- DROP TYPE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]
Syntax
DROP TYPE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]Syntax diagrams
Read left to right. Branches are choices, bypasses are optional, loops repeat. Select an underlined parameter to open its rule.
Definition PG 18
DROP TYPE [ IF EXISTS ] name [, ...] [ CASCADE | RESTRICT ]
Description
DROP TYPE removes a user-defined data type. Only the owner of a type can remove it.
Parameters
IF EXISTSDo not throw an error if the type does not exist. A notice is issued in this case.
nameThe name (optionally schema-qualified) of the data type to remove.
CASCADEAutomatically drop objects that depend on the type (such as table columns, functions, and operators), and in turn all objects that depend on those objects (see Section 5.15).
RESTRICTRefuse to drop the type if any objects depend on it. This is the default.
Examples
To remove the data type box:
DROP TYPE box;
Compatibility
This command is similar to the corresponding command in the SQL standard, apart from the IF EXISTS option, which is a PostgreSQL extension. But note that much of the CREATE TYPE command and the data type extension mechanisms in PostgreSQL differ from the SQL standard.
See Also
ALTER TYPE, CREATE TYPECompare versions
Source references
Full definition and evidence JSON
Definition sources
center · PostgreSQL 18 · wiki-repair-20261023:81fcc6d8400f22def36022a0b30d806146ba6e326e4910607338761cf3721d34
Text language: en · wiki-repair-20261023:81fcc6d8400f22def36022a0b30d806146ba6e326e4910607338761cf3721d34