Compartilhar via


sp_droprolemember (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Remove uma conta de segurança de uma função do SQL Server no banco de dados atual.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Em vez disso, use ALTER ROLE .

Convenções de sintaxe de Transact-SQL

Sintaxe

Sintaxe para SQL Server e SQL do Azure no Edge.

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

Sintaxe para Azure Synapse Analytics e PDW (Analytics Platform System).

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

Observação

Não há suporte a essa sintaxe para o pool de SQL sem servidor no Azure Synapse Analytics.

Argumentos

@rolename [ = ] N'nome da função'

O nome da função da qual o membro está sendo removido. @rolename é sysname, sem padrão. @rolename deve existir no banco de dados atual.

@membername [ = ] N'membername'

O nome da conta de segurança que está sendo removida da função. @membername é sysname, sem padrão. @membername pode ser um usuário de banco de dados, outra função de banco de dados, uma conta do Windows ou um grupo do Windows. @membername deve existir no banco de dados atual.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_droprolemember Remove um membro de uma função de banco de dados excluindo uma linha da sysmembers tabela. Quando um membro é removido de uma função, ele perde todas as permissões que possui por associação a essa função.

Para remover um usuário de uma função de servidor fixa, use sp_dropsrvrolemembero . Os usuários não podem ser removidos da função pública e dbo não podem ser removidos de nenhuma função.

Use sp_helpuser para ver os membros de uma função do SQL Server e use ALTER ROLE para adicionar um membro a uma função.

Permissões

Requer ALTER permissão na função.

Exemplos

O exemplo a seguir remove o usuário JonB da função Sales.

EXEC sp_droprolemember 'Sales', 'Jonb';

Exemplos: Azure Synapse Analytics e PDW (Analytics Platform System)

O exemplo a seguir remove o usuário JonB da função Sales.

EXEC sp_droprolemember 'Sales', 'JonB'