sp_droprolemember (Transact-SQL)

Применимо к:SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure Azure Synapse Analytics AnalyticsPlatform System (PDW)

Удаляет учетную запись безопасности из роли SQL Server в текущей базе данных.

Внимание

Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте ALTER ROLE .

Соглашения о синтаксисе Transact-SQL

Синтаксис

Синтаксис ДЛЯ SQL Server и Azure SQL Edge:

sp_droprolemember
    [ @rolename = ] N'rolename'
    , [ @membername = ] N'membername'
[ ; ]

Синтаксис для Azure Synapse Analytics и Parallel Data Warehouse:

sp_droprolemember N'rolename', 'membername'
[ ; ]

Примечание.

Этот синтаксис не поддерживается бессерверным пулом SQL в Azure Synapse Analytics.

Аргументы

[ @rolename = ] N'rolename'

Имя роли, из которой удаляется член. @rolename — sysname без значения по умолчанию. @rolename должны существовать в текущей базе данных.

[ @membername = ] N'membername'

Имя учетной записи безопасности, удаленной из роли. @membername — sysname без значения по умолчанию. @membername может быть пользователем базы данных, другой ролью базы данных, учетной записью Windows или группой Windows. @membername должны существовать в текущей базе данных.

Значения кода возврата

0 (успешно) или 1 (сбой).

Замечания

sp_droprolemember Удаляет члена из роли базы данных, удалив строку из sysmembers таблицы. Когда член удаляется из роли, член теряет все разрешения, у него есть членство в этой роли.

Чтобы удалить пользователя из предопределенных ролей сервера, используйте sp_dropsrvrolemember. Пользователи не могут быть удалены из общедоступной роли и dbo не могут быть удалены из какой-либо роли.

Используется sp_helpuser для просмотра членов роли SQL Server и использования ALTER ROLE для добавления участника в роль.

Разрешения

Требуется ALTER разрешение на роль.

Примеры

В следующем примере производится удаление пользователя JonB из роли Sales.

EXEC sp_droprolemember 'Sales', 'Jonb';

Примеры: Azure Synapse Analytics и система платформы аналитики (PDW)

В следующем примере производится удаление пользователя JonB из роли Sales.

EXEC sp_droprolemember 'Sales', 'JonB'