sp_grantdbaccess (Transact-SQL)

Adiciona um usuário ao banco de dados atual.

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

Consulte também

Referência

Procedimentos armazenados de segurança (Transact-SQL)

CREATE USER (Transact-SQL)

DROP USER (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)