sp_dropuser (Transact-SQL)

Aplica-se: SQL Server

Remove um usuário do banco de dados do banco de dados atual. sp_dropuser fornece compatibilidade com versões anteriores do SQL Server.

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_dropuser [ @name_in_db = ] N'name_in_db'
[ ; ]

Argumentos

@name_in_db [ = ] N'name_in_db'

O nome do usuário a ser removido. @name_in_db é sysname, sem padrão. @name_in_db deve existir no banco de dados atual. Ao especificar uma conta do Windows, use o nome pelo qual o banco de dados conhece essa conta.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_dropusersp_revokedbaccess executa para remover o usuário do banco de dados atual.

Use sp_helpuser para exibir uma lista dos nomes de usuário que podem ser removidos do banco de dados atual.

Quando um usuário de banco de dados é removido, qualquer alias para esse usuário também é removido. Se o usuário possuir um esquema vazio com o mesmo nome do usuário, o esquema será descartado. Se o usuário possuir outros protegíveis no banco de dados, o usuário não será descartado. A propriedade dos objetos deve ser transferida primeiro a outro principal. Para obter mais informações, consulte ALTER AUTHORIZATION. A remoção de um usuário de banco de dados remove automaticamente as permissões associadas a esse usuário e remove o usuário de todas as funções de banco de dados das quais ele é membro.

sp_dropuserNão pode ser usado para remover os usuários do proprietário do banco de dados (DBO) INFORMATION_SCHEMA ou o usuário convidado dos master bancos de dados ORtempdb. Em bancos de dados que não são do sistema, EXEC sp_dropuser 'guest' revoga CONNECT a permissão do convidado do usuário, mas o usuário em si não é descartado.

sp_dropuser 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 Albert do banco de dados atual.

EXEC sp_dropuser 'Albert';
GO