dropdb

Name

dropdb -- remove um banco de dados do PostgreSQL

Synopsis

dropdb [opções...] nome_bd

Entradas

-h, --host hospedeiro

Especifica o nome da máquina onde o servidor está executando. Se o nome iniciar por uma barra (/), é considerado como sendo o diretório do soquete do domínio Unix.

-p, --port porta

Especifica a porta Internet TCP/IP, ou o soquete do domínio local Unix, onde o servidor está aguardando as conexões.

-U, --username nome_do_usuário

Nome do usuário para se conectar.

-W, --password

Força a solicitação da senha.

-e, --echo

Exibe os comandos que o dropdb gera e envia para o servidor.

-q, --quiet

Não exibe a resposta.

-i, --interactive

Solicita a confirmação antes de fazer qualquer operação destrutiva.

nome_bd

Especifica o nome do banco de dados a ser removido. O banco de dados deve ser um dos bancos de dados existentes no PostgreSQL desta instalação.

As opções -h, -p, -U, -W e -e são passadas literalmente para o psql.

Saídas

DROP DATABASE

O banco de dados foi removido com sucesso.

dropdb: Database removal failed.

Algum erro aconteceu.

Havendo uma condição de erro, a mensagem de erro do servidor é exibida. Consulte o comando DROP DATABASE e o aplicativo psql para ver as causas possíveis.

Descrição

O dropdb remove do PostgreSQL um banco de dados existente. Para executar este comando é necessário ser um superusuário, ou o dono do banco de dados.

O dropdb é um script envoltório que usa o comando SQL DROP DATABASE através do terminal interativo do PostgreSQL psql. Portanto, não existe nada em especial sobre remover bancos de dados desta ou daquela maneira, significando que o psql deve ser encontrado pelo script, e que o servidor de banco de dados deve estar executando na máquina de destino. Também se aplicam os padrões definidos e as variáveis de ambiente disponíveis para o psql e para a biblioteca cliente libpq.

Utilização

Para remover o banco de dados demo do servidor de banco de dados padrão:

$ dropdb demo
DROP DATABASE

Para remover o banco de dados demo usando o servidor na máquina eden, porta 5000, com confirmação e vendo o comando utilizado:

$ dropdb -p 5000 -h eden -i -e demo
Database "demo" will be permanently deleted.
Are you sure? (y/n) y
DROP DATABASE "demo"
DROP DATABASE