Supported versions: Current (18) / 17 / 16 / 15 / 14

Development versions: 19 / 20devel

Unsupported versions: 13 / 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1

Historical version. PostgreSQL 7.1 has reached end of support. See the current manual.

ALTER GROUP

Name

ALTER GROUP -- Add users to a group, remove users from a group

Synopsis

ALTER GROUP name ADD USER username [, ... ]
ALTER GROUP name DROP USER username [, ... ]

Inputs

name: The name of the group to modify.
username: Users which are to be added or removed from the group. The user names must exist.

Outputs

ALTER GROUP: Message returned if the alteration was successful.

Description

ALTER GROUP is used to add or remove users from a group. Only database superusers can use this command. Adding a user to a group does not create the user. Similarly, removing a user from a group does not drop the user itself.

Use CREATE GROUP to create a new group and DROP GROUP to remove a group.

Usage

Add users to a group:

ALTER GROUP staff ADD USER karl, john

Remove a user from a group:

ALTER GROUP workers DROP USER beth

Compatibility

SQL92

There is no ALTER GROUP statement in SQL92. The concept of roles is similar.

Report a documentation issue

Read the upstream documentation. For corrections, first check the current manual.