sp_adduser (Transact-SQL)

向当前数据库中添加新的用户。

重要说明重要提示

后续版本的 Microsoft SQL Server 将删除该功能。 请避免在新的开发工作中使用该功能,并着手修改当前还在使用该功能的应用程序。请改用 CREATE USER

主题链接图标Transact-SQL 语法约定

语法

sp_adduser [ @loginame = ] 'login' 
        [ , [ @name_in_db = ] 'user' ] 
        [ , [ @grpname = ] 'role' ] 

参数

  • [ @loginame = ] 'login'
    SQL Server 登录或 Windows 登录的名称。login 的数据类型为 sysname,无默认值。login 必须是现有的 SQL Server 登录名或 Windows 登录名。

  • [ @name_in_db = ] 'user'
    新数据库用户的名称。user 的数据类型为 sysname,默认值为 NULL。如果未指定 user,则新数据库用户的名称默认为 login 名称。指定 user 将为数据库中新用户赋予一个不同于服务器级别登录名的名称。

  • [ @grpname = ] 'role'
    新用户成为其成员的数据库角色。role 的数据类型为 sysname,默认值为 NULL。role 必须是当前数据库中的有效数据库角色。

返回代码值

0(成功)或 1(失败)

注释

sp_adduser 还将创建一个具有该用户名的架构。

在添加完用户之后,可以使用 GRANT、DENY 和 REVOKE 等语句来定义控制用户所执行的活动的权限。

使用 sys.server_principals 可显示有效登录名的列表。

使用 sp_helprole 可显示有效角色名的列表。当指定一个角色时,用户会自动地获得那些为该角色定义的权限。如果未指定角色,则用户获得的权限将是授予默认 public 角色的权限。若要将用户添加到角色,必须提供 user name 的值。((username 可与 login_id 相同。)

用户 guest 已经存在于每个数据库中。如果此前禁用了用户,则添加用户 guest 可启用该用户。默认情况下,会在新数据库中禁用用户 guest

不能在用户定义事务内执行 sp_adduser

您不能添加 guest 用户,因为 guest 用户已经存在于每个数据库内。若要启用 guest 用户,请按如下方式授予 guest CONNECT 权限:

GRANT CONNECT TO guest;
GO

权限

要求具有数据库的所有权。

示例

A. 添加数据库用户

以下示例使用现有的 SQL Server 登录名 Vidur,将数据库用户 Vidur 添加到当前数据库中的现有 Recruiting 角色。

EXEC sp_adduser 'Vidur', 'Vidur', 'Recruiting'

B. 添加数据库用户(使用相同的登录 ID)

以下示例将用户 Arvind 添加到 SQL Server 登录名 Arvind 的当前数据库。该用户属于默认的 public 角色。

EXEC sp_adduser 'Arvind'

C. 添加数据库用户(使用不同于其服务器级别登录的名称)

以下示例将 SQL Server 登录名 BjornR 添加到具有用户名 Bjorn 的当前数据库,并将数据库用户 Bjorn 添加到 Production 数据库角色。

EXEC sp_adduser 'BjornR', 'Bjorn', 'Production'