dropdb — remove um banco de dados do PostgreSQL
dropdb [opção_de_conexão...] [opção...] nome_do_banco_de_dados
A aplicação dropdb remove um banco de dados do PostgreSQL existente. O usuário que executa este comando deve ser um superusuário do banco de dados, ou o dono do banco de dados.
A aplicação dropdb é um invólucro para o comando SQL DROP DATABASE. Não há diferença efetiva entre remover bancos de dados por meio desse utilitário, ou por meio de outros métodos de acesso ao servidor.
O dropdb aceita os seguintes argumentos de linha de comando:
nome_do_banco_de_dadosEspecifica o nome do banco de dados a ser removido.
-e--echoEcoa os comandos que dropdb gera e envia para o servidor.
-f--forceTenta encerrar todas as conexões existentes com o banco de dados de destino. Veja DROP DATABASE para obter mais informações sobre esta opção.
-i--interactiveSolicita uma confirmação antes de fazer algo destrutivo.
-V--versionMostra a versão do dropdb, e termina.
--if-existsNão será relatado nenhum erro se o banco de dados não existir. É emitido um aviso neste caso.
-?--helpMostra a ajuda sobre os argumentos da linha de comando do dropdb, e termina.
O dropdb também aceita os seguintes argumentos de linha de comando para os parâmetros de conexão:
-h hospedeiro--host=hospedeiroEspecifica o nome de hospedeiro da máquina na qual o servidor está sendo executado. Se começar com uma barra, será usado como o diretório para o soquete de domínio Unix.
-p porta--port=portaEspecifica a porta TCP, ou extensão de arquivo de soquete de domínio Unix local, na qual o servidor está aguardando conexões.
-U nome_do_usuário--username=nome_do_usuárioNome de usuário para se conectar como.
-w--no-password
Nunca emita uma solicitação de senha.
Se o servidor exigir autenticação por senha, e uma senha não
estiver disponível por outros meios, como o arquivo
.pgpass, a tentativa de conexão falhará.
Esta opção pode ser útil em tarefas em lote e scripts nos quais
nenhum usuário está presente para inserir uma senha.
-W--passwordForça o dropdb solicitar a senha antes de conectar ao banco de dados.
Esta opção nunca é essencial, porque o
dropdb solicita automaticamente
a senha se o servidor exigir autenticação por senha.
No entanto, o dropdb irá desperdiçar
uma tentativa de conexão ao descobrir que o servidor pede uma senha.
Em alguns casos vale a pena digitar -W para
evitar a tentativa extra de conexão.
--maintenance-db=nome_do_banco_de_dados
Especifica o nome do banco de dados ao qual se conectar para
remover o banco de dados.
Se não for especificado, será usado o banco de dados
postgres; se não existir (ou se for o nome
do banco de dados que está sendo removido), será usado
template1.
Pode ser uma
cadeia de caracteres de conexão.
Neste caso, os parâmetros da cadeia de conexão têm precedência
sobre quaisquer opções de linha de comando conflitantes.
PGHOSTPGPORTPGUSERParâmetros de conexão padrão.
PG_COLOR
Especifica se devem ser usadas cores nas mensagens de diagnóstico.
Os valores possíveis são always,
auto e never.
Este utilitário, como a maioria dos outros utilitários do PostgreSQL, também usa as variáveis de ambiente com suporte pela libpq (veja Variáveis de ambiente).
Em caso de dificuldade, veja o comando DROP DATABASE e o utilitário psql para obter informações sobre possíveis problemas e mensagens de erro. O servidor de banco de dados deverá estar ativo no hospedeiro especificado. Além disso, se aplicam todas as configurações de conexão padrão e variáveis de ambiente usadas pela biblioteca cliente libpq.
Para remover o banco de dados demo no servidor
de banco de dados padrão:
$dropdb demo
Para remover o banco de dados demo, usando o
servidor no hospedeiro eden, porta 5000, com
confirmação, e mostrando o comando subjacente:
$dropdb -p 5000 -h eden -i -e demoBanco de dados "demo" será permanentemente removido. Você tem certeza? (s/n)sDROP DATABASE demo;
Exemplo 90. Exemplo do tradutor
Remoção de banco de dados na máquina local
Remoção do banco de dados demo no
servidor hospedeiro localhost, porta 5432,
através do usuário postgres:
$dropdb -p 5432 -h localhost -e -i demoBanco de dados "demo" será permanentemente removido. Você tem certeza? (s/n)sSenha: SELECT pg_catalog.set_config('search_path', '', false); DROP DATABASE demo;
Neste exemplo a senha fornecida foi a do usuário
postgres usado para remover o banco de dados
demo.