sp_droprolemember (Transact-SQL)
Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Removes a security account from a SQL Server role in the current database.
Important
This feature will be removed in a future version of SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature. Use ALTER ROLE instead.
Transact-SQL syntax conventions
Syntax
Syntax for SQL Server and Azure SQL Edge:
sp_droprolemember
[ @rolename = ] N'rolename'
, [ @membername = ] N'membername'
[ ; ]
Syntax for Azure Synapse Analytics and Parallel Data Warehouse:
sp_droprolemember N'rolename', 'membername'
[ ; ]
Note
This syntax is not supported by serverless SQL pool in Azure Synapse Analytics.
Arguments
[ @rolename = ] N'rolename'
The name of the role from which the member is being removed. @rolename is sysname, with no default. @rolename must exist in the current database.
[ @membername = ] N'membername'
The name of the security account being removed from the role. @membername is sysname, with no default. @membername can be a database user, another database role, a Windows account, or a Windows group. @membername must exist in the current database.
Return code values
0
(success) or 1
(failure).
Remarks
sp_droprolemember
removes a member from a database role by deleting a row from the sysmembers
table. When a member is removed from a role, the member loses any permissions it has by membership in that role.
To remove a user from a fixed server role, use sp_dropsrvrolemember
. Users can't be removed from the public role, and dbo can't be removed from any role.
Use sp_helpuser
to see the members of a SQL Server role, and use ALTER ROLE to add a member to a role.
Permissions
Requires ALTER
permission on the role.
Examples
The following example removes the user JonB
from the role Sales
.
EXEC sp_droprolemember 'Sales', 'Jonb';
Examples: Azure Synapse Analytics and Analytics Platform System (PDW)
The following example removes the user JonB
from the role Sales
.
EXEC sp_droprolemember 'Sales', 'JonB'
Related content
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho