Skip to content

Latest commit

 

History

History
72 lines (51 loc) · 2.28 KB

sp-dropapprole-transact-sql.md

File metadata and controls

72 lines (51 loc) · 2.28 KB
title description author ms.author ms.reviewer ms.date ms.service ms.subservice ms.topic f1_keywords helpviewer_keywords dev_langs
sp_dropapprole (Transact-SQL)
sp_dropapprole removes an application role from the current database.
VanMSFT
vanto
randolphwest
11/28/2023
sql
system-objects
reference
sp_dropapprole_TSQL
sp_dropapprole
sp_dropapprole
TSQL

sp_dropapprole (Transact-SQL)

[!INCLUDE SQL Server]

Removes an application role from the current database.

Important

[!INCLUDE ssNoteDepFutureAvoid] Use DROP APPLICATION ROLE instead.

:::image type="icon" source="../../includes/media/topic-link-icon.svg" border="false"::: Transact-SQL syntax conventions

Syntax

sp_dropapprole [ @rolename = ] N'rolename'
[ ; ]

Arguments

[ @rolename = ] N'rolename'

The application role to remove. @rolename is sysname, with no default. @rolename must exist in the current database.

Return code values

0 (success) or 1 (failure).

Remarks

sp_dropapprole can only be used to remove application roles. If a role owns any securables, the role can't be dropped. Before dropping an application role that owns securables, you must first transfer ownership of the securables, or drop them.

sp_dropapprole can't be executed within a user-defined transaction.

Permissions

Requires ALTER ANY APPLICATION ROLE permission on the database.

Examples

The following example removes the SalesApp application role from the current database.

EXEC sp_dropapprole 'SalesApp';

Related content