Postgresql 中文操作指南

dropuser

dropuser — 删除 PostgreSQL 用户帐户

Synopsis

dropuser [ connection-option …​] [ option …​] [ username ]

Description

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

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

Options

dropuser 接受以下命令行参数：

  • username

    • 指定要删除的 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 以避免额外的连接尝试。

Environment

  • PGHOST_PGPORT_PGUSER

    • Default connection parameters

  • PG_COLOR

    • 指定是否在诊断消息中使用颜色。可能的值为 always 、 auto 和 never 。

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

Diagnostics

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

Examples

若要从默认数据库服务器中删除用户 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;

See Also

createuser ， DROP ROLE