Compartilhar via


sp_revokedbaccess (Transact-SQL)

Aplica-se: SQL Server

Remove um usuário do 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 = ] N'name_in_db'
[ ; ]

Argumentos

@name_in_db [ = ] N'name_in_db'

O nome do usuário do banco de dados a ser removido. @name_in_db é sysname, sem padrão. @name_in_db pode ser o nome de um logon do 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 ele é conhecido no banco de dados.

Valores do código de retorno

0 (sucesso) 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 de 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, consulte ALTER AUTHORIZATION.

sp_revokedbaccess não pode ser executado em 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