# 丢弃用户

dropuser — 删除 PostgreSQL 用户帐户

# 概要

丢弃用户 [连接选项...][option...] [用户名]

# 描述

dropuser 删除现有的 PostgreSQL 用户。只有超级用户和具有创造者权限可以删除 PostgreSQL 用户。(要删除超级用户,您自己必须是超级用户。)

dropuser 是 SQL 命令的包装器删除角色.通过此实用程序删除用户和通过其他访问服务器的方法删除用户之间没有有效的区别。

# 选项

dropuser 接受以下命令行参数:

用户名

指定要删除的 PostgreSQL 用户的名称。如果在命令行中未指定名称,系统将提示您输入名称,并且-一世/- 交互的使用选项。

-e
- 回声

回显 dropuser 生成并发送到服务器的命令。

-一世
- 交互的

在实际删除用户之前提示确认,如果在命令行中未指定用户名,则提示输入用户名。

-V
- 版本

打印 dropuser 版本并退出。

--如果存在

如果用户不存在,不要抛出错误。在这种情况下发出通知。

-?
- 帮助

显示有关 dropuser 命令行参数的帮助,然后退出。

dropuser 还接受以下命令行参数作为连接参数:

-h *主持人*
--主机=*主持人*

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

-p *港口*
--端口=*港口*

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

-U *用户名*
--用户名=*用户名*

要连接的用户名(不是要删除的用户名)。

-w
--无密码

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

-W
- 密码

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

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

# 环境

PGHOST
PGPORT
PG用户

默认连接参数

PG_COLOR

指定是否在诊断消息中使用颜色。可能的值为总是,汽车绝不.

与大多数其他 PostgreSQL 实用程序一样,此实用程序也使用 libpq 支持的环境变量(请参阅第 34.15 节)。

# 诊断

如有困难,请参阅删除角色psql用于讨论潜在问题和错误消息。数据库服务器必须在目标主机上运行。此外,libpq 前端库使用的任何默认连接设置和环境变量都将适用。

# 例子

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

$ dropuser joe

删除用户使用主机上的服务器伊甸园,端口 5000,进行验证并查看底层命令:

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

# 也可以看看

创建用户,删除角色