.\\" auto-generated by docbook2man-spec $Revision: 1.25 $
.TH "ALTER GROUP" "7" "2002-11-22" "SQL - Language Statements" "SQL Commands"
.SH NAME
ALTER GROUP \- add users to a group or remove users from a group
.SH SYNOPSIS
.sp
.nf
ALTER GROUP \fIname\fR ADD USER \fIusername\fR [, ... ]
ALTER GROUP \fIname\fR DROP USER \fIusername\fR [, ... ]
  
.sp
.fi
.SS "INPUTS"
.PP
.TP
\fB\fIname\fB\fR
The name of the group to modify.
.TP
\fB\fIusername\fB\fR
Users which are to be added or removed from the group. The user
names must exist.
.PP
.SS "OUTPUTS"
.PP
.TP
\fBALTER GROUP\fR
Message returned if the alteration was successful.
.PP
.SH "DESCRIPTION"
.PP
\fBALTER GROUP\fR 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.
.PP
Use CREATE GROUP [\fBcreate_group\fR(7)]
to create a new group and DROP GROUP [\fBdrop_group\fR(7)] to remove a group.
.SH "USAGE"
.PP
Add users to a group:
.sp
.nf
ALTER GROUP staff ADD USER karl, john;
.sp
.fi
Remove a user from a group:
.sp
.nf
ALTER GROUP workers DROP USER beth;
.sp
.fi
.SH "COMPATIBILITY"
.SS "SQL92"
.PP
There is no \fBALTER GROUP\fR statement in
SQL92. The concept of roles is
similar.