sp_grantdbaccess (Transact-SQL)

Adiciona um usuário ao banco de dados atual.

Observação importanteImportante

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 seu lugar.

Ícone de vínculo de tópicoConvenções de 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 do Windows e logons do Windows devem ser qualificados com um nome de domínio do Windows no formato Domínio\logon; 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 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