sp_dropgroup (Transact-SQL)
Removes a role from the current database.
Important
sp_dropgroup provides compatibility with earlier versions of Microsoft SQL Server. This feature will be removed in the next version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use DROP ROLE instead.
.gif "Topic link icon")
Transact-SQL Syntax Conventions
Syntax
sp_dropgroup [ @rolename = ] 'role'
Arguments
- [ @rolename = ] 'role'
Is the role to remove from the current database. role is sysname, with no default.
Return Code Values
0 (success) or 1 (failure)
Remarks
sp_dropgroup calls DROP ROLE. This is the preferred way to remove a role. For information about removing a role from the database, see DROP ROLE (Transact-SQL).
sp_dropgroup cannot be executed within a user-defined transaction.
Permissions
Requires CONTROL permission on the role or ALTER ANY ROLE permission on the database.
Examples
The following example uses DROP ROLE to remove the role my_role from the current database. This is the preferred method.
DROP ROLE my_role;
GO
See Also
Reference
Security Stored Procedures (Transact-SQL)
System Stored Procedures (Transact-SQL)
DROP ROLE (Transact-SQL)
sys.database_principals (Transact-SQL)
sys.database_role_members (Transact-SQL)