DROP SCHEMA — remove a schema
DROP SCHEMA [ IF EXISTS ] name
[, ...] [ CASCADE | RESTRICT ]
DROP SCHEMA
removes schemas from the database.
A schema can only be dropped by its owner or a superuser. Note that the owner can drop the schema (and thereby all contained objects) even if they do not own some of the objects within the schema.
IF EXISTS
Do not throw an error if the schema does not exist. A notice is issued in this case.
name
The name of a schema.
CASCADE
Automatically drop objects (tables, functions, etc.) that are contained in the schema, and in turn all objects that depend on those objects (see Section 5.15).
RESTRICT
Refuse to drop the schema if it contains any objects. This is the default.
Using the CASCADE
option might make the command remove objects in other schemas besides the one(s) named.
To remove schema mystuff
from the database, along with everything it contains:
DROP SCHEMA mystuff CASCADE;
DROP SCHEMA
is fully conforming with the SQL standard, except that the standard only allows one schema to be dropped per command, and apart from the IF EXISTS
option, which is a PostgreSQL extension.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.