sp_revokedbaccess (Transact-SQL)

Aplica-se a:SQL Server

Remove um usuário de banco de dados do 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 DROP USER .

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_revokedbaccess [ @name_in_db = ] 'name'  

Argumentos

[ @name_in_db = ] 'name' É o nome do usuário do banco de dados a ser removido. name é um sysname sem padrão. name pode ser o nome de um logon de servidor, um logon do Windows ou um grupo do Windows e deve existir no banco de dados atual. Ao especificar um logon do Windows ou um grupo do Windows, especifique o nome pelo qual o logon ou grupo é conhecido no banco de dados.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

Quando o usuário de banco de dados é removido, as permissões e os aliases que dependem do usuário também são removidos.

sp_revokedbaccess pode remover apenas usuários do banco de dados do banco de dados atual. Antes de remover um usuário que possui objetos no banco de dados atual, é necessário transferir a propriedade dos objetos ou descartá-los do banco de dados. Para obter mais informações, confira ALTER AUTHORIZATION (Transact-SQL).

sp_revokedbaccess não pode ser executado dentro de uma transação definida pelo usuário.

Permissões

Requer a permissão ALTER ANY USER no banco de dados.

Exemplos

O exemplo a seguir remove o usuário de banco de dados mapeado para Edmonds\LolanSo do banco de dados atual.

EXEC sp_revokedbaccess 'Edmonds\LolanSo';  
GO  

Confira também

Procedimentos armazenados de segurança (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
DROP USER (Transact-SQL)
ALTER AUTHORIZATION (Transact-SQL)