sp_grantdbaccess (Transact-SQL)
Adiciona um usuário ao banco de dados atual.
![]() |
---|
Esse recurso será removido em uma versão futura do Microsoft SQL Server. Evite usar esse recurso em desenvolvimentos novos e planeje modificar os aplicativos que atualmente o utilizam. Use CREATE USER em vez disso. |
Convenções da sintaxe Transact-SQL
Sintaxe
sp_grantdbaccess [ @loginame = ] 'login'
[ , [ @name_in_db = ] 'name_in_db' [ OUTPUT ] ]
Argumentos
[ @loginame = ] **'**login '
É o nome do grupo do Windows, logon do Windows ou logon do SQL Server a ser mapeado para o novo usuário do banco de dados. Os nomes de grupos e logons do Windows devem ser qualificados com um nome de domínio do Windows no formato Domain\login; por exemplo, LONDON\Joeb. O logon ainda não pode ser mapeado para um usuário no banco de dados. login é sysname, sem padrão.[ @name_in_db=] 'name_in_db' [ OUTPUT]
É o nome do novo usuário de banco de dados. name_in_db é uma variável OUTPUT com o tipo de dados sysname, e um padrão NULL. Se não for especificado, será usado login. Se for especificado como uma variável OUTPUT com um valor NULL, @name_in_db será definido como login. name_in_db ainda não deve existir no banco de dados atual.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
sp_grantdbaccess chama CREATE USER, que dá suporte a opções adicionais. Para obter informações sobre como criar usuários de banco de dados, consulte CREATE USER (Transact-SQL). Para remover um usuário de um banco de dados, use DROP USER.
sp_grantdbaccess não pode ser executado em uma transação definida pelo usuário.
Permissões
Requer associação na função de banco de dados fixa db_owner ou na função de banco de dados fixa db_accessadmin.
Exemplos
O exemplo a seguir usa CREATE USER para adicionar um usuário de banco de dados para o logon do Windows Edmonds\LolanSo ao banco de dados atual. O novo usuário chama-se Lolan. Este é o método preferencial para criar um usuário de banco de dados.
CREATE USER Lolan FOR LOGIN [Edmonds\LolanSo];
GO