dropuser
描述 dropuser 删除一个现有的 PostgreSQL 用户。超级用户可以使用此命令删除任何角色；否则，只能删除非超级用户角色，而且只有拥有 CREATEROLE 权限并已被授予目标角色上的 ADMIN OPTION 的用户才能这样做。 dropuser 是 SQL 命令 DROP ROLE 的包装器。通过此工具删除用户与通过其他访问服务器的方法删除用户，在效果上并无区别。 选项 dropuser 接受下列命令行参数： username 指定要移除的 PostgreSQL 用户名。如果命…
当前查看 PostgreSQL 18。
中文定义与说明
命令行工具 dropuser [ connection-option ...] [ option ...] [ username ]。
同版本中文手册节选
描述
dropuser 删除一个现有的
PostgreSQL 用户。超级用户可以使用此命令删除任何角色；否则，只能删除非超级用户角色，而且只有拥有
CREATEROLE 权限并已被授予目标角色上的
ADMIN OPTION 的用户才能这样做。
dropuser 是 SQL 命令
DROP ROLE 的包装器。通过此工具删除用户与通过其他访问服务器的方法删除用户，在效果上并无区别。
选项
dropuser 接受下列命令行参数：
username指定要移除的 PostgreSQL 用户名。如果命令行中未指定名称，且使用了
-i/--interactive选项，则会提示输入名称。-e--echo回显 dropuser 生成并发送给服务器的命令。
-i--interactive在实际移除该用户之前提示确认；如果命令行中未指定用户名，也会提示输入用户名。
-V--version打印 dropuser 版本并退出。
--if-exists如果该用户不存在，则不要抛出错误。这种情况下会发出一个提示。
-?--help显示有关 dropuser 命令行参数的帮助并退出。
dropuser 也接受下列用于连接参数的命令行参数：
-hhost--host=host指定服务器运行所在主机的主机名。如果该值以斜杠开头，则它将被用作 Unix 域套接字所在目录。
-pport--port=port指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。
-Uusername--username=username用于连接的用户名（不是要删除的用户名）。
-w--no-password从不发出密码提示。如果服务器要求密码认证，而密码又无法通过诸如
.pgpass文件之类的其他方式获得，则连接尝试将失败。该选项适合没有用户在场输入密码的批处理作业和脚本。-W--password强制 dropuser 在连接到数据库之前提示输入密码。
这个选项绝非必需，因为如果服务器要求密码认证，dropuser 会自动提示输入密码。不过，dropuser 会浪费一次连接尝试来发现服务器需要密码。在某些情况下，输入
-W值得一试，以避免这次额外的连接尝试。
说明
描述 dropuser 删除一个现有的 PostgreSQL 用户。超级用户可以使用此命令删除任何角色；否则，只能删除非超级用户角色，而且只有拥有 CREATEROLE 权限并已被授予目标角色上的 ADMIN OPTION 的用户才能这样做。 dropuser 是 SQL 命令 DROP ROLE 的包装器。通过此工具删除用户与通过其他访问服务器的方法删除用户，在效果上并无区别。 选项 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
- 程序版本
- 18.6
- 参考清单
- 客户端程序
- 选项定义组
- 10
用法
dropuser [ connection-option ...] [ option ...] [ username ]手册中的选项
| 选项与参数 | 说明 |
|---|---|
| -e --echo | 回显 dropuser 生成并发送给服务器的命令。 |
| -i --interactive | 在实际移除该用户之前提示确认；如果命令行中未指定用户名，也会提示输入用户名。 |
| -V --version | 打印 dropuser 版本并退出。 |
| --if-exists | 如果该用户不存在，则不要抛出错误。这种情况下会发出一个提示。 |
| -? --help | 显示有关 dropuser 命令行参数的帮助并退出。 |
| -h host --host= host | 指定服务器运行所在主机的主机名。如果该值以斜杠开头，则它将被用作 Unix 域套接字所在目录。 |
| -p port --port= port | 指定服务器监听连接所用的 TCP 端口或本地 Unix 域套接字文件扩展名。 |
| -U username --username= username | 用于连接的用户名（不是要删除的用户名）。 |
| -w --no-password | 从不发出密码提示。如果服务器要求密码认证，而密码又无法通过诸如 .pgpass 文件之类的其他方式获得，则连接尝试将失败。该选项适合没有用户在场输入密码的批处理作业和脚本。 |
| -W --password | 强制 dropuser 在连接到数据库之前提示输入密码。 |
环境变量
| 变量 | 含义 |
|---|---|
| PGHOST PGPORT PGUSER | 默认连接参数 |
| PG_COLOR | 指定诊断消息是否使用颜色。可选值为 always 、 auto 和 never 。 |
文档与源码
来源构建
- 版本
- 18.6
- 构建
- https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
- 来源指纹
ee8d1a3612338fd9adf250730cb640fcc5233b5491337cc00a316a44e3a0b9f8
版本比较
PostgreSQL 17 → 18: 无变化。
比较已记录的接口与属性，排除来源指纹和构建元数据。某个样本中没有记录，不能据此判断实际引入或移除的版本。
相关条目
导出 JSON · 返回命令行工具 · 收录范围为 PostgreSQL 10 至 20；最早采样版本不一定是实际引入版本。