ALTER GROUP

更改角色名称或成员资格

英文手册覆盖始于 PostgreSQL 6.4. 来源历史与运行验证各自保留独立版本边界。

当前阅读 PG 18·选择有来源记录的版本

7.0 7.1 7.2 7.3 7.4 8.0 8.1 8.2 8.3 8.4 9.0 9.1 9.2 9.3 9.4 9.5 9.6 10 11 12 13 14 15 16 17 18 19 20

anchor: SQL-ALTERGROUP
file: sql-altergroup.html
lang: en
name: ALTER GROUP
purpose: change role name or membership
purpose zh: 未知
sections same as: 未知
slug: 18

语法

ALTER GROUP role_specification ADD USER user_name [, ... ]
ALTER GROUP role_specification DROP USER user_name [, ... ]

where role_specification can be:
role_name
| CURRENT_ROLE
| CURRENT_USER
| SESSION_USER

ALTER GROUP group_name RENAME TO new_name

语法图

从左向右阅读；分支表示选择，旁路表示可选，循环表示重复。点击带下划线的参数可打开对应规则。

ALTER GROUP · 语法 2

role_specification

ALTER GROUP · 语法 3

版本定义 PG 18

ALTER GROUP role_specification ADD USER user_name [, ... ]
ALTER GROUP role_specification DROP USER user_name [, ... ]

其中 role_specification 可以是：
role_name
| CURRENT_ROLE
| CURRENT_USER
| SESSION_USER

ALTER GROUP group_name RENAME TO new_name

描述

ALTER GROUP更改用户组的属性。这是一个已废弃的命令，但出于向后兼容的考虑仍然接受它，因为组（以及用户）已经被更一般的角色概念所取代。

前两个变体将用户加入一个组，或将其从组中移除。（为此目的，任何角色都可以充当“用户”或“组”。）这些变体实际上等效于对名为“组”的角色授予或撤销成员资格，因此更推荐使用GRANT或 REVOKE。请注意，GRANT和REVOKE还提供了此命令没有的附加选项，例如可以授予和撤销ADMIN OPTION，以及指定授权者（grantor）。

第三个变体更改组的名称。这与使用ALTER ROLE重命名该角色完全等效。

参数

group_name: 要修改的组（角色）的名称。
user_name: 要加入该组或从该组中移除的用户（角色）。这些用户必须已经存在；ALTER GROUP不会创建或删除用户。
new_name: 该组的新名称。

示例

向组中添加用户：

ALTER GROUP staff ADD USER karl, john;

从组中移除用户：

ALTER GROUP workers DROP USER beth;

兼容性

SQL 标准中没有ALTER GROUP语句。

另见

GRANT, REVOKE, ALTER ROLE

比较版本

完整来源事实

synopsis html

ALTER GROUP <em class="replaceable"><code>role_specification</code></em> ADD USER <em class="replaceable"><code>user_name</code></em> [, ... ]
ALTER GROUP <em class="replaceable"><code>role_specification</code></em> DROP USER <em class="replaceable"><code>user_name</code></em> [, ... ]

<span class="phrase">where <em class="replaceable"><code>role_specification</code></em> can be:</span>

    <em class="replaceable"><code>role_name</code></em>
  | CURRENT_ROLE
  | CURRENT_USER
  | SESSION_USER

ALTER GROUP <em class="replaceable"><code>group_name</code></em> RENAME TO <em class="replaceable"><code>new_name</code></em>

synopsis text

ALTER GROUP role_specification ADD USER user_name [, ... ]
ALTER GROUP role_specification DROP USER user_name [, ... ]

where role_specification can be:
role_name
| CURRENT_ROLE
| CURRENT_USER
| SESSION_USER

ALTER GROUP group_name RENAME TO new_name

来源引用

完整定义与证据 JSON

定义来源

center · PostgreSQL 18 · a709ab85

正文语言: zh-Hans · 1b5ca64c