---

Transact-SQL 参考

sp_adduser
为当前数据库中的新用户添加安全帐户。包括此过程是为了向后兼容。请使用 sp_grantdbaccess。
语法
sp_adduser [ @loginame = ] 'login'
[ , [ @name_in_db = ] 'user' ]
[ , [ @grpname = ] 'group' ]
参数
[@loginame =] 'login'
用户的登录名称。login 的数据类型是 sysname，没有默认值。login 必须是现有 Microsoft® SQL Server™ 登录或 Microsoft Windows NT® 用户。
[@name_in_db =] 'user'
新用户的名称。user 的数据类型为 sysname，其默认值为 NULL。如果没有指定 user，则用户的名称默认为 login 名称。指定 user 即为新用户在数据库中给予一个不同于 SQL Server 上的登录 ID 的名称。
[@grpname =] 'group'
组或角色，新用户自动地成为其成员。group 的数据类型为 sysname，默认值为 NULL。group 必须是当前数据库中有效的组或角色。Microsoft SQL Server 7.0 使用角色而不是组。
返回代码值
0（成功）或 1（失败）
注释
SQL Server 用户名可以包含 1 到 128 个字符，包括字母、符号和数字。但是，用户名不能：
含有反斜线符号 (\)。
为 NULL，或为空字符串 ('')。
在添加完用户之后，可以使用 GRANT、DENY 和 REVOKE 语句来定义权限，这些权限控制着用户进行的活动。
使用 sp_helplogin 可显示有效登录名的列表。
使用 sp_helprole 可显示有效角色名的列表。当指定一个角色时，用户会自动地获得为该角色定义的那些权限。如果没有指定角色，则用户获得的权限将是授予默认 public 角色的权限。若要将用户添加到角色，必须提供 username 的值（username 可与 login_id 相同）。
为了访问数据库，必须使用 sp_adduser 或 sp_grantdbaccess 对登录授予访问权，或者数据库中必须存在 guest 安全帐户。
不能在用户定义的事务内执行 sp_adduser。
权限
只有 sysadmin 固定服务器角色的 dbo 和成员才能执行 sp_adduser。
示例
A. 添加用户
下面的示例使用现有的登录 Victoria，将用户 Victoria 添加到当前数据库中现有的 fort_mudge 角色中。
EXEC sp_adduser 'Victoria', 'Victoria', 'fort_mudge'
B. 添加用户名（使用相同的登录 ID）
下面的示例为登录 Margaret 将默认用户名 Margaret 添加到当前数据库，该用户名属于默认的 public 角色。
EXEC sp_adduser 'Margaret'
C. 添加用户（使用不同的用户名）
下面的示例将 Haroldq 登录添加到当前的数据库中并使用 Harold 用户名，该用户名属于 fort_mudge 角色。
EXEC sp_adduser 'Haroldq', 'Harold', 'fort_mudge'

---