PostgreSQL 7.4.11 Documentation
Prev | Fast Backward |  | Fast Forward | Next

# ALTER GROUP

## Name

ALTER GROUP -- change a user group

## Synopsis

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

    ALTER GROUP groupname RENAME TO newname

## Description

`ALTER GROUP` is used to change a user group. The first two variants 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.

The third variant changes the name of the group. Only a database superuser can rename groups.

## Parameters

`groupname`

  The name of the group to modify.

`username`

  Users which are to be added or removed from the group. The users must exist.

`newname`

  The new name of the group.

## Examples

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

There is no `ALTER GROUP` statement in the SQL standard. The concept of roles is similar.

## See Also

CREATE GROUP, DROP GROUP

Prev | Home | Next
ALTER FUNCTION | Up | ALTER LANGUAGE