sp_change_users_login

更改当前数据库中 SQL Server 用户与 Microsoft® SQL Server™ 登录之间的关系。

语法

sp_change_users_login [ @Action= ] 'action'
    [ , [ @UserNamePattern= ] 'user' ]
    [ , [ @loginName= ] 'login' ]

参数

[ @Action= ] 'action'

描述此过程要执行的操作。action 的数据类型为 varchar(10)，可以是下面的某个值。

值	描述
Auto_Fix	将当前数据库的 sysusers 表中的用户条目链接到 syslogins 中同名的登录上。建议检查 Auto_Fix 语句的结果，确认建立的链接是预期的结果。在对安全性较为敏感的情况下，避免使用 Auto_Fix。Auto_Fix 对链接作出最好的估计，授予用户的访问权限可能比预期的要多。 user 必须是当前数据库中的有效用户，login 必须为 NULL、长度为零的字符串 ('') 或不指定。
Report	列出当前数据库中未链接到任何登录的用户及其对应的安全标识号 (SID)。 user 和 login 必须为 NULL、长度为零的字符串 ('') 或不指定。
Update_One	将当前数据库中指定的 user 链接到 login。login 必须已经存在。必须指定 user 和 login。

[@UserNamePattern=] 'user'

是当前数据库中的 SQL Server 用户的名称。user 的数据类型为 sysname，默认值为 NULL。sp_change_users_login 只能用于 SQL Server 登录和用户的安全帐户；而不能用于 Microsoft Windows NT® 用户。

[@LoginName=] 'login'

SQL Server 登录的名称。login 的数据类型为 sysname，默认值为 NULL。

返回代码值

0（成功）或 1（失败）

结果集

列名	数据类型	描述
UserName	sysname	登录名。
UserSID	varbinary(85)	登录安全标识符。

注释

使用此过程将当前数据库中用户的安全帐户链接到不同的登录。如果用户登录已更改，则使用 sp_change_users_login 将用户链接到新的登录，而不会丢失用户的权限。

login 不能为 sa，而 user 不能为 dbo、guest 或 INFORMATION_SCHEMA 用户。

不能在用户定义的事务中执行 sp_change_users_login。

权限

任何 public 角色的成员均可执行带有 Report 选项的 sp_change_users_login。只有 sysadmin 固定服务器角色的成员才能指定 Auto_Fix 选项。只有 sysadmin 或 db_owner 角色的成员才能指定 Update_One 选项。

示例

A. 显示登录映射的当前用户的报告

下面的示例生成当前数据库中的用户及其安全标识符的报告。

EXEC sp_change_users_login 'Report'

B. 更改用户的登录

下面的示例更改 pubs 数据库中的用户 Mary 与现有登录之间的链接，链接到新的登录 NewMary 上（使用 sp_addlogin 添加）。

--Add the new login.
USE master
go
EXEC sp_addlogin 'NewMary'
go
--Change the user account to link with the 'NewMary' login.
USE pubs
go
EXEC sp_change_users_login 'Update_One', 'Mary', 'NewMary'