.\\" auto-generated by docbook2man-spec $Revision: 1.25 $
.TH "DROP SCHEMA" "7" "2003-11-02" "SQL - Language Statements" "SQL Commands"
.SH NAME
DROP SCHEMA \- remove a schema

.SH SYNOPSIS
.sp
.nf
DROP SCHEMA \fIname\fR [, ...] [ CASCADE | RESTRICT ]
.sp
.fi
.SH "DESCRIPTION"
.PP
\fBDROP SCHEMA\fR removes schemas from the database.
.PP
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 he does not own some of the objects within the schema.
.SH "PARAMETERS"
.TP
\fB\fIname\fB\fR
The name of a schema.
.TP
\fBCASCADE\fR
Automatically drop objects (tables, functions, etc.) that are
contained in the schema.
.TP
\fBRESTRICT\fR
Refuse to drop the schema if it contains any objects. This is
the default.
.SH "EXAMPLES"
.PP
To remove schema mystuff from the database,
along with everything it contains:
.sp
.nf
DROP SCHEMA mystuff CASCADE;
.sp
.fi
.SH "COMPATIBILITY"
.PP
\fBDROP SCHEMA\fR is fully conforming with the SQL
standard, except that the standard only allows one schema to be
dropped per command.
.SH "SEE ALSO"
ALTER SCHEMA [\fBalter_schema\fR(7)], CREATE SCHEMA [\fBcreate_schema\fR(l)]