↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

百科 / SQL 命令 / 角色与权限

SQL COMMAND · 角色与权限

DROP ROLE

移除一个数据库角色

remove a database role

DROP角色与权限引入 8.1现存至 20 devel1 次语法变更

动词
DROP
对象
ROLE
引入版本
8.1
状态
现存
语法变更次数
1
手册小节数
6

本站手册 · 18官方文档 ↗

版本轨迹

相对 PostgreSQL 17 无变化。

语法铁道图 PostgreSQL 18

沿轨道从左向右阅读,分岔表示选择,绕行表示可选,回环表示重复。方框为参数,点击带下划线的参数可展开子规则。

DROP ROLE IF EXISTS name ,

语法概要

DROP ROLE [ IF EXISTS ] name [, ...]

PostgreSQL 18 手册 · 查看完整参考页

描述

DROP ROLE 移除指定的角色。要删除超级用户角色,你自己也必须是超级用户;要删除非超级用户角色,你必须拥有 CREATEROLE 权限,并且已被授予该角色上的 ADMIN OPTION。

如果某角色仍在该集簇的任何数据库中被引用,则不能移除该角色;若是如此将引发错误。在删除该角色之前,你必须删除它拥有的所有对象(或者重新分配这些对象的拥有关系),并撤销该角色在其他对象上被授予的任何权限。REASSIGN OWNED 和 DROP OWNED 命令可用于此目的;更详细的讨论见第 21.4 节。

不过,不必手工移除与该角色相关的角色成员资格;DROP ROLE 会自动撤销目标角色在其他角色中的任何成员资格,以及其他角色在目标角色中的任何成员资格。其他角色不会被删除,也不会受到影响。

参数

IF EXISTS

如果该角色不存在,则不要抛出错误。这种情况下会发出一个提示。

name

要移除的角色名称。

注解

PostgreSQL 包含一个程序 dropuser,它与此命令具有相同功能(实际上它就是调用此命令),但可以从命令 shell 中运行。

示例

删除一个角色:

DROP ROLE jonathan;

兼容性

SQL 标准定义了 DROP ROLE,但它一次只允许删除一个角色,并且规定的权限要求也不同于 PostgreSQL。

另见

语法演化

相邻大版本之间的差异,新的在前。版本号链接到对应快照。

  1. PostgreSQL 17← 16正文更新

    正文更新
  2. PostgreSQL 16← 15正文更新

    正文更新
  3. PostgreSQL 14← 13正文更新

    正文更新
  4. PostgreSQL 9.6← 9.5正文更新

    正文更新
  5. PostgreSQL 9.1← 9.0正文更新

    正文更新
  6. PostgreSQL 8.2← 8.1语法变化

    + DROP ROLE [ IF EXISTS ] name [, ...]正文更新
  7. PostgreSQL 8.1← 8.0新增此命令

同组命令

命令动词对象版本变动最近变更
ROLES & PRIVILEGES角色与权限20 条↑
GRANTGRANT— 1717 次
定义访问权限现存
REVOKEREVOKE— 1719 次
撤销访问权限现存
ALTER DEFAULT PRIVILEGESALTERDEFAULT PRIVILEGES 186 次
定义默认访问权限现存
CREATE GROUPCREATEGROUP 198 次
定义一个新的数据库角色现存
ALTER GROUPALTERGROUP 144 次
更改角色名称或成员资格现存
DROP GROUPDROPGROUP 8.22 次
移除一个数据库角色现存
SECURITY LABELSECURITYLABEL 126 次
定义或更改应用于对象的安全标签现存
DROP OWNEDDROPOWNED 142 次
移除一个数据库角色所拥有的数据库对象现存
REASSIGN OWNEDREASSIGNOWNED 142 次
更改一个数据库角色所拥有的数据库对象的所有权现存
CREATE POLICYCREATEPOLICY 142 次
为一个表定义一条新的行级安全策略现存
ALTER POLICYALTERPOLICY 141 次
更改一条行级安全策略的定义现存
DROP POLICYDROPPOLICY 9.61 次
从一个表中移除一条行级安全策略现存
CREATE ROLECREATEROLE 177 次
定义一个新的数据库角色现存
ALTER ROLEALTERROLE 1410 次
更改数据库角色现存
DROP ROLEDROPROLE 8.21 次
移除一个数据库角色现存
SET ROLESETROLE 9.01 次
设置当前会话的当前用户标识符现存
SET SESSION AUTHORIZATIONSETSESSION AUTHORIZATION 9.02 次
设置当前会话的会话用户标识符和当前用户标识符现存
CREATE USERCREATEUSER 1912 次
定义一个新的数据库角色现存
ALTER USERALTERUSER 1417 次
更改数据库角色现存
DROP USERDROPUSER 8.23 次
移除一个数据库角色现存