dropuser — eliminar una cuenta de usuario de PostgreSQL
dropuser [opción-de-conexión...] [opción...] [nombre-de-usuario]
dropuser elimina un usuario de
PostgreSQL existente.
Los superusuarios pueden usar este comando para eliminar cualquier rol; de lo contrario, solo
se pueden eliminar roles que no sean superusuarios, y solo por parte de un usuario que posea
el privilegio CREATEROLE y al que se le haya otorgado
ADMIN OPTION en el rol objetivo.
dropuser es un envoltorio alrededor del
comando SQL DROP ROLE.
No hay ninguna diferencia efectiva entre eliminar usuarios a través de
esta utilidad y a través de otros métodos para acceder al servidor.
dropuser acepta los siguientes argumentos de línea de comandos:
nombre-de-usuario
Especifica el nombre del usuario de PostgreSQL a eliminar.
Se te pedirá un nombre si no se especifica ninguno en la línea de comandos
y se utiliza la opción -i/--interactive.
-e--echoMuestra los comandos que dropuser genera y envía al servidor.
-i--interactivePide confirmación antes de eliminar realmente al usuario, y pide el nombre de usuario si no se especifica ninguno en la línea de comandos.
-V--versionMuestra la versión de dropuser y sale.
--if-existsNo lances un error si el usuario no existe. Se emitirá un aviso en este caso.
-?--helpMuestra la ayuda sobre los argumentos de línea de comandos de dropuser y sale.
dropuser también acepta los siguientes argumentos de línea de comandos para los parámetros de conexión:
-h host--host=hostEspecifica el nombre de host de la máquina en la que se está ejecutando el servidor. Si el valor comienza con una barra diagonal, se utiliza como el directorio para el socket de dominio Unix.
-p puerto--port=puertoEspecifica el puerto TCP o la extensión del archivo de socket de dominio Unix local en el que el servidor está escuchando conexiones.
-U nombre-de-usuario--username=nombre-de-usuarioNombre de usuario con el que conectarse (no el nombre de usuario a eliminar).
-w--no-password
Nunca solicites una contraseña. Si el servidor requiere
autenticación por contraseña y no hay una contraseña disponible por
otros medios como un archivo .pgpass, el
intento de conexión fallará. Esta opción puede ser útil en
trabajos por lotes (batch) y scripts donde no hay ningún usuario presente para introducir una
contraseña.
-W--passwordFuerza a dropuser a solicitar una contraseña antes de conectarse a una base de datos.
Esta opción nunca es indispensable, ya que
dropuser solicitará automáticamente
una contraseña si el servidor exige autenticación por contraseña.
Sin embargo, dropuser desperdiciará un
intento de conexión para descubrir que el servidor requiere una contraseña.
En algunos casos, vale la pena escribir -W para evitar el
intento de conexión adicional.
PGHOSTPGPORTPGUSERParámetros de conexión por omisión
PG_COLOR
Especifica si se debe usar color en los mensajes de diagnóstico. Los valores posibles
son always, auto y
never.
Esta utilidad, al igual que la mayoría de las otras utilidades de PostgreSQL, también utiliza las variables de entorno admitidas por libpq (consulta la Section 32.15).
En caso de dificultad, consulta la DROP ROLE y la psql para ver discusiones sobre problemas potenciales y mensajes de error. El servidor de bases de datos debe estar ejecutándose en el host de destino. Además, se aplicará cualquier configuración de conexión por omisión y variable de entorno utilizada por la biblioteca front-end libpq.
Para eliminar al usuario joe del servidor de bases de datos
por omisión:
$dropuser joe
Para eliminar al usuario joe usando el servidor en el host
eden, puerto 5000, con confirmación y echando un vistazo al
comando subyacente:
$dropuser -p 5000 -h eden -i -e joeRole "joe" will be permanently removed. Are you sure? (y/n)yDROP ROLE joe;