sys.sp_grantdbaccess (Transact-SQL)

Aplica-se a: SQL Server

Adiciona um utilizador da base de dados à base de dados atual.

Importante

Esse recurso será removido em uma versão futura do SQL Server. Evite usar esse recurso em novos trabalhos de desenvolvimento e planeje modificar aplicativos que atualmente usam esse recurso. Utilize CREATE USER em substituição.

Transact-SQL convenções de sintaxe

Syntax

sys.sp_grantdbaccess
    [ @loginame = ] N'loginame'
    [ , [ @name_in_db = ] N'name_in_db' OUTPUT ]
[ ; ]

Arguments

[ @loginame = ] N'loginame'

O nome do grupo Windows, login do Windows ou login do SQL Server, a mapear para o novo utilizador da base de dados. @loginame é sysname, sem padrão. Nomes de grupos Windows e logins Windows devem ser qualificados com um nome de domínio Windows no formato <domain>\<login>; por exemplo, LONDON\Joeb. O login já não pode estar mapeado para um utilizador na base de dados.

[ @name_in_db = ] N'name_in_db' SAÍDA

O nome para o novo utilizador da base de dados. @name_in_db é um OUTPUT parâmetro do tipo sysname. Se não for especificado, @loginame é usado. Se especificado como uma OUTPUT variável com valor de NULL, @name_in_db é definido como @loginame. @name_in_db não deve já existir na base de dados atual.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Remarks

sp_grantdbaccess chama CREATE USER, que suporta opções adicionais. Para informações sobre a criação de utilizadores de bases de dados, veja CREATE USER. Para remover um utilizador de base de dados de uma base de dados, use DROP USER.

sp_grantdbaccess não pode ser executado dentro de uma transação definida pelo usuário.

Permissions

Requer a pertença ao papel de base de dados fixo db_owner ou ao papel de base de dados fixo db_accessadmin .

Examples

O exemplo seguinte serve CREATE USER para adicionar um utilizador de base de dados para a conta Edmonds\LolanSo Windows à base de dados atual, que é o método preferido para criar um utilizador de base de dados. O novo utilizador chama-se Lolan.

CREATE USER Lolan FOR LOGIN [Edmonds\LolanSo];
GO