{"Entry":{"collection":"sql","key":"alter-group","name":"ALTER GROUP","aliases":["altergroup"],"metadata":{"aliases":["altergroup"],"changed_in":["7.4","9.0","9.5","14"],"changes":[{"from":"6.5","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"added","synopsis":null,"to":"7.0"},{"from":"7.0","purpose_changed":false,"renamed":{"from_file":"sql-altergroup.htm","to_file":"sql-altergroup.html"},"sections":{"added":[],"changed":["description","usage"],"removed":[]},"status":"changed","synopsis":null,"to":"7.1"},{"from":"7.1","purpose_changed":true,"renamed":null,"sections":{"added":[],"changed":["usage"],"removed":[]},"status":"changed","synopsis":null,"to":"7.2"},{"from":"7.3","purpose_changed":true,"renamed":null,"sections":{"added":["parameters","examples","see_also"],"changed":["description","compatibility"],"removed":["usage"]},"status":"changed","synopsis":{"added":["ALTER GROUP groupname ADD USER username [, ... ]","ALTER GROUP groupname DROP USER username [, ... ]","ALTER GROUP groupname RENAME TO newname"],"removed":["ALTER GROUP name ADD USER username [, ... ]","ALTER GROUP name DROP USER username [, ... ]"]},"to":"7.4"},{"from":"7.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["description","parameters"],"removed":[]},"status":"changed","synopsis":null,"to":"8.0"},{"from":"8.0","purpose_changed":true,"renamed":null,"sections":{"added":[],"changed":["description","parameters","compatibility","see_also"],"removed":[]},"status":"changed","synopsis":null,"to":"8.1"},{"from":"8.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["parameters"],"removed":[]},"status":"changed","synopsis":{"added":["ALTER GROUP group_name ADD USER user_name [, ... ]","ALTER GROUP group_name DROP USER user_name [, ... ]","ALTER GROUP group_name RENAME TO new_name"],"removed":["ALTER GROUP groupname ADD USER username [, ... ]","ALTER GROUP groupname DROP USER username [, ... ]","ALTER GROUP groupname RENAME TO newname"]},"to":"9.0"},{"from":"9.4","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":["ALTER GROUP role_specification ADD USER user_name [, ... ]","ALTER GROUP role_specification DROP USER user_name [, ... ]","role_name","| CURRENT_USER","| SESSION_USER"],"removed":["ALTER GROUP group_name ADD USER user_name [, ... ]","ALTER GROUP group_name DROP USER user_name [, ... ]"]},"to":"9.5"},{"from":"9.6","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["description"],"removed":[]},"status":"changed","synopsis":null,"to":"10"},{"from":"13","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":[],"removed":[]},"status":"changed","synopsis":{"added":["| CURRENT_ROLE","| CURRENT_USER"],"removed":[]},"to":"14"},{"from":"15","purpose_changed":false,"renamed":null,"sections":{"added":[],"changed":["description"],"removed":[]},"status":"changed","synopsis":null,"to":"16"}],"content_hash":"f0d64f683ddf6ee19edcde0db44812f8620bbb02867c17f33fb0dc50224d81e1","editorial":{},"first_version":"7.0","group":"role","imported_at":"2026-09-30T17:43:38.082879+08:00","last_version":"20","name":"ALTER GROUP","object":"GROUP","position":5004,"present_in":["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"],"purpose":"change role name or membership","purpose_zh":"","related":["grant","revoke","alter-role"],"slug":"alter-group","source_rev":"a709ab85","synopsis":"ALTER GROUP role_specification ADD USER user_name [, ... ]\nALTER GROUP role_specification DROP USER user_name [, ... ]\n\nwhere role_specification can be:\nrole_name\n| CURRENT_ROLE\n| CURRENT_USER\n| SESSION_USER\n\nALTER GROUP group_name RENAME TO new_name","verb":"ALTER"}},"Definition":{"Collection":"sql","Key":"alter-group","SourceDatabase":"center","Version":"18","SourceTable":"sqlcmd","SourceKey":"alter-group","SourceRevision":"a709ab85","Facts":{"anchor":"SQL-ALTERGROUP","file":"sql-altergroup.html","lang":"en","name":"ALTER GROUP","purpose":"change role name or membership","purpose_zh":"","related":["grant","revoke","alter-role"],"sections":[{"html":"\u003cp\u003e\u003ccode class=\"command\"\u003eALTER GROUP\u003c/code\u003e changes the attributes of a user group. This is an obsolete command, though still accepted for backwards compatibility, because groups (and users too) have been superseded by the more general concept of roles.\u003c/p\u003e\u003cp\u003eThe first two variants add users to a group or remove them from a group. (Any role can play the part of either a \u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003euser\u003c/span\u003e”\u003c/span\u003e or a \u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003egroup\u003c/span\u003e”\u003c/span\u003e for this purpose.) These variants are effectively equivalent to granting or revoking membership in the role named as the \u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003egroup\u003c/span\u003e”\u003c/span\u003e; so the preferred way to do this is to use \u003ca href=\"/docs/18/sql-grant.html\" title=\"GRANT\"\u003e\u003ccode class=\"command\"\u003eGRANT\u003c/code\u003e\u003c/a\u003e or \u003ca href=\"/docs/18/sql-revoke.html\" title=\"REVOKE\"\u003e\u003ccode class=\"command\"\u003eREVOKE\u003c/code\u003e\u003c/a\u003e. Note that \u003ccode class=\"command\"\u003eGRANT\u003c/code\u003e and \u003ccode class=\"command\"\u003eREVOKE\u003c/code\u003e have additional options which are not available with this command, such as the ability to grant and revoke \u003ccode class=\"literal\"\u003eADMIN OPTION\u003c/code\u003e, and the ability to specify the grantor.\u003c/p\u003e\u003cp\u003eThe third variant changes the name of the group. This is exactly equivalent to renaming the role with \u003ca href=\"/docs/18/sql-alterrole.html\" title=\"ALTER ROLE\"\u003e\u003ccode class=\"command\"\u003eALTER ROLE\u003c/code\u003e\u003c/a\u003e.\u003c/p\u003e","key":"description","title":"Description"},{"html":"\u003cdiv class=\"variablelist\"\u003e\u003cdl class=\"variablelist\"\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003e\u003cem class=\"replaceable\"\u003e\u003ccode\u003egroup_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003eThe name of the group (role) to modify.\u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003e\u003cem class=\"replaceable\"\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003eUsers (roles) that are to be added to or removed from the group. The users must already exist; \u003ccode class=\"command\"\u003eALTER GROUP\u003c/code\u003e does not create or drop users.\u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003e\u003cem class=\"replaceable\"\u003e\u003ccode\u003enew_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003eThe new name of the group.\u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e","key":"parameters","title":"Parameters"},{"html":"\u003cp\u003eAdd users to a group:\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eALTER GROUP staff ADD USER karl, john;\n\u003c/pre\u003e\u003cp\u003eRemove a user from a group:\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eALTER GROUP workers DROP USER beth;\n\u003c/pre\u003e","key":"examples","title":"Examples"},{"html":"\u003cp\u003eThere is no \u003ccode class=\"command\"\u003eALTER GROUP\u003c/code\u003e statement in the SQL standard.\u003c/p\u003e","key":"compatibility","title":"Compatibility"},{"html":"\u003cspan class=\"simplelist\"\u003e\u003ca href=\"/wiki/sql/grant/?v=18\" title=\"GRANT\"\u003e\u003cspan class=\"refentrytitle\"\u003eGRANT\u003c/span\u003e\u003c/a\u003e, \u003ca href=\"/wiki/sql/revoke/?v=18\" title=\"REVOKE\"\u003e\u003cspan class=\"refentrytitle\"\u003eREVOKE\u003c/span\u003e\u003c/a\u003e, \u003ca href=\"/wiki/sql/alter-role/?v=18\" title=\"ALTER ROLE\"\u003e\u003cspan class=\"refentrytitle\"\u003eALTER ROLE\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e","key":"see_also","title":"See Also"}],"sections_same_as":"","slug":"18","synopsis_html":"ALTER GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_specification\u003c/code\u003e\u003c/em\u003e ADD USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e [, ... ]\nALTER GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_specification\u003c/code\u003e\u003c/em\u003e DROP USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e [, ... ]\n\n\u003cspan class=\"phrase\"\u003ewhere \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_specification\u003c/code\u003e\u003c/em\u003e can be:\u003c/span\u003e\n\n    \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e\n  | CURRENT_ROLE\n  | CURRENT_USER\n  | SESSION_USER\n\nALTER GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003egroup_name\u003c/code\u003e\u003c/em\u003e RENAME TO \u003cem class=\"replaceable\"\u003e\u003ccode\u003enew_name\u003c/code\u003e\u003c/em\u003e","synopsis_text":"ALTER GROUP role_specification ADD USER user_name [, ... ]\nALTER GROUP role_specification DROP USER user_name [, ... ]\n\nwhere role_specification can be:\nrole_name\n| CURRENT_ROLE\n| CURRENT_USER\n| SESSION_USER\n\nALTER GROUP group_name RENAME TO new_name"},"ManualEvidence":{},"MeasuredEvidence":{}},"Text":{"Collection":"sql","Key":"alter-group","SourceDatabase":"pgweb","Version":"18","Locale":"zh-Hans","Title":"ALTER GROUP","Summary":"更改角色名称或成员资格","BodyHTML":"\u003cpre\u003eALTER GROUP role_specification ADD USER user_name [, ... ]\nALTER GROUP role_specification DROP USER user_name [, ... ]\n\n其中 role_specification 可以是：\nrole_name\n| CURRENT_ROLE\n| CURRENT_USER\n| SESSION_USER\n\nALTER GROUP group_name RENAME TO new_name\u003c/pre\u003e\u003csection\u003e\u003ch2\u003e描述\u003c/h2\u003e\u003cp\u003e\u003ccode\u003eALTER GROUP\u003c/code\u003e更改用户组的属性。这是一个已废弃的命令，但出于向后兼容的考虑仍然接受它，因为组（以及用户）已经被更一般的角色概念所取代。\u003c/p\u003e\u003cp\u003e前两个变体将用户加入一个组，或将其从组中移除。（为此目的，任何角色都可以充当\u003cspan\u003e“\u003cspan\u003e用户\u003c/span\u003e”\u003c/span\u003e或\u003cspan\u003e“\u003cspan\u003e组\u003c/span\u003e”\u003c/span\u003e。）这些变体实际上等效于对名为\u003cspan\u003e“\u003cspan\u003e组\u003c/span\u003e”\u003c/span\u003e的角色授予或撤销成员资格，因此更推荐使用\u003ca href=\"/docs/18/sql-grant.html\" title=\"GRANT\" rel=\"nofollow\"\u003e\u003ccode\u003eGRANT\u003c/code\u003e\u003c/a\u003e或 \u003ca href=\"/docs/18/sql-revoke.html\" title=\"REVOKE\" rel=\"nofollow\"\u003e\u003ccode\u003eREVOKE\u003c/code\u003e\u003c/a\u003e。请注意，\u003ccode\u003eGRANT\u003c/code\u003e和\u003ccode\u003eREVOKE\u003c/code\u003e还提供了此命令没有的附加选项，例如可以授予和撤销\u003ccode\u003eADMIN OPTION\u003c/code\u003e，以及指定授权者（grantor）。\u003c/p\u003e\u003cp\u003e第三个变体更改组的名称。这与使用\u003ca href=\"/docs/18/sql-alterrole.html\" title=\"ALTER ROLE\" rel=\"nofollow\"\u003e\u003ccode\u003eALTER ROLE\u003c/code\u003e\u003c/a\u003e重命名该角色完全等效。\u003c/p\u003e\u003c/section\u003e\u003csection\u003e\u003ch2\u003e参数\u003c/h2\u003e\u003cdiv\u003e\u003cdl\u003e\u003cdt\u003e\u003cspan\u003e\u003cem\u003e\u003ccode\u003egroup_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003e要修改的组（角色）的名称。\u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan\u003e\u003cem\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003e要加入该组或从该组中移除的用户（角色）。这些用户必须已经存在；\u003ccode\u003eALTER GROUP\u003c/code\u003e不会创建或删除用户。\u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan\u003e\u003cem\u003e\u003ccode\u003enew_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003e该组的新名称。\u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e\u003c/section\u003e\u003csection\u003e\u003ch2\u003e示例\u003c/h2\u003e\u003cp\u003e向组中添加用户：\u003c/p\u003e\u003cpre\u003eALTER GROUP staff ADD USER karl, john;\n\u003c/pre\u003e\u003cp\u003e从组中移除用户：\u003c/p\u003e\u003cpre\u003eALTER GROUP workers DROP USER beth;\n\u003c/pre\u003e\u003c/section\u003e\u003csection\u003e\u003ch2\u003e兼容性\u003c/h2\u003e\u003cp\u003eSQL 标准中没有\u003ccode\u003eALTER GROUP\u003c/code\u003e语句。\u003c/p\u003e\u003c/section\u003e\u003csection\u003e\u003ch2\u003e另见\u003c/h2\u003e\u003cspan\u003e\u003ca href=\"/wiki/sql/grant/?v=18\" title=\"GRANT\" rel=\"nofollow\"\u003e\u003cspan\u003eGRANT\u003c/span\u003e\u003c/a\u003e, \u003ca href=\"/wiki/sql/revoke/?v=18\" title=\"REVOKE\" rel=\"nofollow\"\u003e\u003cspan\u003eREVOKE\u003c/span\u003e\u003c/a\u003e, \u003ca href=\"/wiki/sql/alter-role/?v=18\" title=\"ALTER ROLE\" rel=\"nofollow\"\u003e\u003cspan\u003eALTER ROLE\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e\u003c/section\u003e","SourceRevision":"1b5ca64c","ContentHash":"b97442ce1033dac397f0b15c8a2988ceba3d12d7a8855eeb65459b4326e2362f","Payload":{"purpose_zh":"更改角色名称或成员资格","sections":[{"html":"\u003cp\u003e\u003ccode class=\"command\"\u003eALTER GROUP\u003c/code\u003e更改用户组的属性。这是一个已废弃的命令，但出于向后兼容的考虑仍然接受它，因为组（以及用户）已经被更一般的角色概念所取代。\u003c/p\u003e\u003cp\u003e前两个变体将用户加入一个组，或将其从组中移除。（为此目的，任何角色都可以充当\u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003e用户\u003c/span\u003e”\u003c/span\u003e或\u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003e组\u003c/span\u003e”\u003c/span\u003e。）这些变体实际上等效于对名为\u003cspan class=\"quote\"\u003e“\u003cspan class=\"quote\"\u003e组\u003c/span\u003e”\u003c/span\u003e的角色授予或撤销成员资格，因此更推荐使用\u003ca href=\"/docs/18/sql-grant.html\" title=\"GRANT\"\u003e\u003ccode class=\"command\"\u003eGRANT\u003c/code\u003e\u003c/a\u003e或 \u003ca href=\"/docs/18/sql-revoke.html\" title=\"REVOKE\"\u003e\u003ccode class=\"command\"\u003eREVOKE\u003c/code\u003e\u003c/a\u003e。请注意，\u003ccode class=\"command\"\u003eGRANT\u003c/code\u003e和\u003ccode class=\"command\"\u003eREVOKE\u003c/code\u003e还提供了此命令没有的附加选项，例如可以授予和撤销\u003ccode class=\"literal\"\u003eADMIN OPTION\u003c/code\u003e，以及指定授权者（grantor）。\u003c/p\u003e\u003cp\u003e第三个变体更改组的名称。这与使用\u003ca href=\"/docs/18/sql-alterrole.html\" title=\"ALTER ROLE\"\u003e\u003ccode class=\"command\"\u003eALTER ROLE\u003c/code\u003e\u003c/a\u003e重命名该角色完全等效。\u003c/p\u003e","key":"description","title":"描述"},{"html":"\u003cdiv class=\"variablelist\"\u003e\u003cdl class=\"variablelist\"\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003e\u003cem class=\"replaceable\"\u003e\u003ccode\u003egroup_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003e要修改的组（角色）的名称。\u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003e\u003cem class=\"replaceable\"\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003e要加入该组或从该组中移除的用户（角色）。这些用户必须已经存在；\u003ccode class=\"command\"\u003eALTER GROUP\u003c/code\u003e不会创建或删除用户。\u003c/p\u003e\u003c/dd\u003e\u003cdt\u003e\u003cspan class=\"term\"\u003e\u003cem class=\"replaceable\"\u003e\u003ccode\u003enew_name\u003c/code\u003e\u003c/em\u003e\u003c/span\u003e\u003c/dt\u003e\u003cdd\u003e\u003cp\u003e该组的新名称。\u003c/p\u003e\u003c/dd\u003e\u003c/dl\u003e\u003c/div\u003e","key":"parameters","title":"参数"},{"html":"\u003cp\u003e向组中添加用户：\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eALTER GROUP staff ADD USER karl, john;\n\u003c/pre\u003e\u003cp\u003e从组中移除用户：\u003c/p\u003e\u003cpre class=\"programlisting\"\u003eALTER GROUP workers DROP USER beth;\n\u003c/pre\u003e","key":"examples","title":"示例"},{"html":"\u003cp\u003eSQL 标准中没有\u003ccode class=\"command\"\u003eALTER GROUP\u003c/code\u003e语句。\u003c/p\u003e","key":"compatibility","title":"兼容性"},{"html":"\u003cspan class=\"simplelist\"\u003e\u003ca href=\"/wiki/sql/grant/?v=18\" title=\"GRANT\"\u003e\u003cspan class=\"refentrytitle\"\u003eGRANT\u003c/span\u003e\u003c/a\u003e, \u003ca href=\"/wiki/sql/revoke/?v=18\" title=\"REVOKE\"\u003e\u003cspan class=\"refentrytitle\"\u003eREVOKE\u003c/span\u003e\u003c/a\u003e, \u003ca href=\"/wiki/sql/alter-role/?v=18\" title=\"ALTER ROLE\"\u003e\u003cspan class=\"refentrytitle\"\u003eALTER ROLE\u003c/span\u003e\u003c/a\u003e\u003c/span\u003e","key":"see_also","title":"另见"}],"sections_same_as":"","synopsis_html":"ALTER GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_specification\u003c/code\u003e\u003c/em\u003e ADD USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e [, ... ]\nALTER GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_specification\u003c/code\u003e\u003c/em\u003e DROP USER \u003cem class=\"replaceable\"\u003e\u003ccode\u003euser_name\u003c/code\u003e\u003c/em\u003e [, ... ]\n\n\u003cspan class=\"phrase\"\u003e其中 \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_specification\u003c/code\u003e\u003c/em\u003e 可以是：\u003c/span\u003e\n\n    \u003cem class=\"replaceable\"\u003e\u003ccode\u003erole_name\u003c/code\u003e\u003c/em\u003e\n  | CURRENT_ROLE\n  | CURRENT_USER\n  | SESSION_USER\n\nALTER GROUP \u003cem class=\"replaceable\"\u003e\u003ccode\u003egroup_name\u003c/code\u003e\u003c/em\u003e RENAME TO \u003cem class=\"replaceable\"\u003e\u003ccode\u003enew_name\u003c/code\u003e\u003c/em\u003e","synopsis_text":"ALTER GROUP role_specification ADD USER user_name [, ... ]\nALTER GROUP role_specification DROP USER user_name [, ... ]\n\n其中 role_specification 可以是：\nrole_name\n| CURRENT_ROLE\n| CURRENT_USER\n| SESSION_USER\n\nALTER GROUP group_name RENAME TO new_name"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["10","11","12","13","14","15","16","17","18","19","20","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"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":null,"Evidence":null}