DROP SCHEMA

DROP SCHEMA — remove um esquema

Sinopse

DROP SCHEMA [ IF EXISTS ] nome_do_esquema [, ...]
            [ CASCADE | RESTRICT ]

Descrição

O comando DROP SCHEMA remove esquemas do banco de dados.

Um esquema só pode ser removido por seu dono ou um superusuário. Note que o dono pode remover o esquema (portanto, todos os objetos nele contidos), mesmo não possuindo alguns dos objetos contidos no esquema.

Parâmetros

IF EXISTS

Não será relatado nenhum erro se o esquema não existir. É emitido um aviso neste caso.

nome_do_esquema

O nome do esquema.

CASCADE

Remove automaticamente os objetos (tabelas, funções, etc.) que estão contidos no esquema e, por sua vez, todos os objetos que dependem desses objetos (veja Acompanhamento de dependência).

RESTRICT

Recusa remover o esquema se este contiver algum objeto. Este é o comportamento padrão.

Nota

A opção CASCADE pode fazer com que o comando remova objetos em outros esquemas, além daquele(s) especificados(s).

Exemplos

Para remover o esquema minhas_coisas do banco de dados, juntamente com tudo o que ele contém:

DROP SCHEMA minhas_coisas CASCADE;

Conformidade

O comando DROP SCHEMA está em total conformidade com o padrão SQL, exceto pelo padrão permitir que somente um esquema seja removido por comando, e também pela opção IF EXISTS, que é uma extensão do PostgreSQL.

Veja também

ALTER SCHEMA, CREATE SCHEMA