dropuser

Name

dropuser -- remove uma conta de usuário do PostgreSQL

Synopsis

dropuser [opções...] [nome_do_usuário]

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.

-e, --echo

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

-q, --quiet

Não exibe a resposta.

-i, --interactive

Solicita a confirmação antes de remover o usuário.

nome_do_usuário

Especifica o nome do usuário do PostgreSQL a ser removido. O nome deve existir na instalação PostgreSQL. Será solicitado o nome caso este não seja fornecido na linha de comando.

As opções -h, -p e -e são passadas literalmente para o psql. As opções -U e -W do psql também estão disponíveis, mas podem causar confusão neste contexto.

Saídas

DROP USER

O usuário foi removido com sucesso.

dropuser: deletion of user "nome_do_usuário" failed

Aconteceu algum erro. O usuário não foi removido.

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

Descrição

O dropuser remove um usuário do PostgreSQL e os bancos de dados que este usuário possui. Somente os usuários com usesuper definido na tabela pg_shadow podem remover usuários do PostgreSQL.

O dropuser é um script envoltório que usa o comando SQL DROP USER através do terminal interativo do PostgreSQL psql. Portanto, não existe nada em especial sobre remover usuários 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 usuário joel do servidor de banco de dados padrão:

$ dropuser joel
DROP USER

Para remover o usuário joel usando o postmaster na máquina eden, porta 5000, com confirmação e vendo o comando utilizado:

$ dropuser -p 5000 -h eden -i -e joel
User "joel" and any owned databases will be permanently deleted.
Are you sure? (y/n) y
DROP USER "joel"
DROP USER