dropuser

dropuser — 删除一个PostgreSQL用户帐户

概要

dropuser[connection-option...] [option...] [username]

dropuser删除一个现有的PostgreSQL用户。超级用户可以使用此命令删除任何角色；否则，只能删除非超级用户角色，并且只能由拥有CREATEROLE权限并已获得目标角色的ADMIN OPTION的用户删除。

dropuser是SQL命令DROP ROLE的一个包装。通过此实用程序删除用户与通过其他方法访问服务器删除用户之间没有实际差异。

dropuser接受以下命令行参数

用户名: 指定要移除的 PostgreSQL 用户的名称。如果在命令行上未指定名称且使用了 -i/--interactive 选项，则系统会提示您输入名称。
-e --echo: 回显 dropuser 生成并发送到服务器的命令。
-i --interactive: 在实际移除用户之前提示确认，如果在命令行上未指定用户名，则提示输入用户名。
-V --version: 打印 dropuser 版本并退出。
--if-exists: 如果用户不存在，则不抛出错误。在这种情况下，会发出通知。
-? --help: 显示有关 dropuser 命令行参数的帮助，并退出。

dropuser还接受以下用于连接参数的命令行参数

-h host --host=host

指定服务器正在运行的机器的主机名。如果该值以斜杠开头，则将其用作 Unix 域套接字的目录。

-p port --port=port

指定服务器正在侦听连接的 TCP 端口或本地 Unix 域套接字文件扩展名。

-U username --username=username

以其身份进行连接的用户名（不是要删除的用户名）。

-w --no-password

从不发出密码提示。如果服务器需要密码身份验证，并且无法通过 .pgpass 文件等其他方式获得密码，则连接尝试将失败。此选项在没有用户输入密码的批处理作业和脚本中很有用。

-W --password

强制 dropuser 在连接到数据库之前提示输入密码。

此选项从不必要，因为如果服务器要求密码验证，dropuser 会自动提示输入密码。但是，dropuser 会浪费一次连接尝试来找出服务器是否需要密码。在某些情况下，值得键入 -W 以避免额外的连接尝试。

此实用程序与大多数其他PostgreSQL实用程序一样，也使用libpq支持的环境变量（请参见第 34.15 节）。

如果遇到困难，请参阅DROP ROLE和psql以了解潜在问题和错误消息的讨论。数据库服务器必须在目标主机上运行。此外，libpq前端库使用的任何默认连接设置和环境变量都将适用。

从默认数据库服务器中删除用户joe

$ dropuser joe

使用主机eden、端口 5000、验证和查看底层命令上的服务器删除用户joe

$ dropuser -p 5000 -h eden -i -e joe
Role "joe" will be permanently removed.
Are you sure? (y/n) y
DROP ROLE joe;