ALTER GROUP

Description

Modifies the attributes of a user group.

Precautions

ALTER GROUP is an alias for ALTER ROLE, and it is not a standard SQL syntax and not recommended. Users can use ALTER ROLE directly.

Syntax

Add users to a group.

ALTER GROUP group_name 
    ADD USER user_name [, ... ];

Remove users from a group.

ALTER GROUP group_name 
    DROP USER user_name [, ... ];

Change the name of the group.

ALTER GROUP group_name 
    RENAME TO new_name;

Parameters

See Parameters in "ALTER ROLE."

Examples

-- Create a user group.
gaussdb=# CREATE GROUP super_users WITH PASSWORD "********";

-- Create a user.
gaussdb=# CREATE ROLE lche WITH PASSWORD "********";

-- Create a user.
gaussdb=# CREATE ROLE jim WITH PASSWORD "********";

-- Add users to a user group.
gaussdb=# ALTER GROUP super_users ADD USER lche, jim;

-- Remove users from a user group.
gaussdb=# ALTER GROUP super_users DROP USER jim;

-- Change the name of a user group.
gaussdb=# ALTER GROUP super_users RENAME TO normal_users;

-- Delete a user.
gaussdb=# DROP ROLE lche, jim;

-- Delete a user group.
gaussdb=# DROP GROUP normal_users;