sp_grantdbaccess (Transact-SQL)
Aplica-se a: SQL Server
Adiciona um usuário ao 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 CREATE USER .
Convenções de sintaxe de 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 do Windows e logons do Windows devem ser qualificados com um nome de domínio do Windows no formato Logon de domínio\; por exemplo, LONDON\Joeb. O logon ainda não pode ser mapeado para um usuário no banco de dados. login é um nome de sistema, sem padrão.
[ @name_in_db = ] 'name_in_db' [ OUTPUT]
É o nome do novo usuário do banco de dados. name_in_db é uma variável OUTPUT com um tipo de dados de sysname e um padrão de NULL. Se não for especificado, o login será usado. Se especificado como uma variável OUTPUT com um valor de NULL, @name_in_db é definido como login. name_in_db ainda não deve existir no banco de dados atual.
Valores do 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 banco de dados 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
Confira também
Procedimentos armazenados de segurança (Transact-SQL)
CREATE USER (Transact-SQL)
DROP USER (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários