sp_droprolemember (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

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 do SQL Server e do Azure SQL Edge:

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

Sintaxe do Azure Synapse Analytics e do Parallel Data Warehouse:

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'nomedafunçã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'nome do membro'

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 tem por associação a essa função.

Para remover um usuário de uma função de servidor fixa, use sp_dropsrvrolemember. Os usuários não podem ser removidos da função pública e o dbo não pode ser removido 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'