sp_revokedbaccess (Transact-SQL)

Removes a database user from the current database.

Important

This feature will be removed in a future 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 USER instead.

Topic link iconTransact-SQL Syntax Conventions

Syntax

sp_revokedbaccess [ @name_in_db = ] 'name'

Arguments

  • [ @name_in_db = ] 'name'
    Is the name of the database user to be removed. name is a sysname with no default. name can be the name of a server login, a Windows login, or a Windows group, and must exist in the current database. When you specify a Windows login or Windows group, specify the name by which it is known in the database.

Return Code Values

0 (success) or 1 (failure)

Remarks

When the database user is removed, the permissions and aliases that depend on the user are also removed.

sp_revokedbaccess can remove only database users from the current database. Before removing a database user that owns objects in the current database, you must either transfer ownership of the objects or drop them from the database. For more information, see ALTER AUTHORIZATION (Transact-SQL).

sp_revokedbaccess cannot be executed within a user-defined transaction.

Permissions

Requires ALTER ANY USER permission on the database.

Examples

The following example removes the database user mapped to Edmonds\LolanSo from the current database.

EXEC sp_revokedbaccess 'Edmonds\LolanSo';
GO