sp_dropuser (Transact-SQL)

  • Artigo

Aplica-se a:SQL Server

Remove um usuário de 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_dropuser Executa sp_revokedbaccess 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 que o usuário, o esquema será descartado. Se o usuário possuir quaisquer 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, confira ALTER AUTHORIZATION (Transact-SQL). 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 quaisquer funções de banco de dados das quais ele seja membro.

sp_dropuserNão pode ser usado para remover os usuários DBO (proprietário do banco de dados) 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 a CONNECT permissão do usuário convidado, mas o próprio usuário 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

Conteúdo relacionado