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. Nomes de grupos do Windows e logons do Windows devem ser qualificados com um nome de domínio do Windows no formato Login 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 sysname, 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 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 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 suporta 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 dentro de uma transação definida pelo usuário.

Permissões

Requer associação à função de banco de dados fixa db_owner ou à 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)