DROP DATABASE

DROP DATABASE — remove um banco de dados

Sinopse

DROP DATABASE [ IF EXISTS ] nome
              [ [ WITH ] ( opção [, ...] ) ]

onde opção pode ser:

    FORCE

Descrição

O comando DROP DATABASE remove um banco de dados. São removidas as entradas do banco de dados no catálogo do sistema, e excluído o diretório que contém os dados. Só pode ser executado pelo dono do banco de dados. Não pode ser executado estando conectado ao banco de dados a ser removido. (Conecte-se ao banco de dados postgres, ou a qualquer outro banco de dados, para executar este comando.) Além disso, se qualquer outro usuário estiver conectado ao banco de dados de destino, este comando irá falhar, a menos que se use a opção FORCE descrita abaixo.

O comando DROP DATABASE não pode ser desfeito. Deve ser usado com cuidado!

Parâmetros

IF EXISTS

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

nome

O nome do banco de dados a ser removido.

FORCE

Tenta interromper todas as conexões existentes com o banco de dados de destino. Isto não irá ocorrer se existirem transações preparadas, encaixes de replicação lógica ativos, ou subscrições, presentes no banco de dados de destino.

São terminadas as conexões dos processos trabalhadores em segundo plano e as demais conexões que o usuário corrente tem permissão para terminar com pg_terminate_backend, descrito em Funções de sinalização do servidor. Se restarem conexões abertas, este comando irá falhar.

Notas

O comando DROP DATABASE não pode ser executado dentro de um bloco de transação.

Este comando não pode ser executado enquanto conectado ao banco de dados de destino. Portanto, pode ser mais conveniente usar o programa dropdb, que é um empacotador em torno desse comando.

Conformidade

Não existe o comando DROP DATABASE no padrão SQL.

Veja também

CREATE DATABASE