sp_change_users_login (Transact-SQL)
Область применения: 
SQL Server
Сопоставляет существующего пользователя базы данных с именем входа SQL Server.
Внимание
Эта функция будет удалена в будущей версии SQL Server. Избегайте использования этого компонента в новых разработках и запланируйте изменение существующих приложений, в которых он применяется. Вместо этого используйте ALTER USER .
Соглашения о синтаксисе Transact-SQL
Синтаксис
sp_change_users_login
[ @Action = ] 'Action'
[ , [ @UserNamePattern = ] N'UserNamePattern' ]
[ , [ @LoginName = ] N'LoginName' ]
[ , [ @Password = ] N'Password' ]
[ ; ]
Аргументы
[ @Action = ] 'Действие'
Описывает действие для выполнения хранимой процедуры. @Action — varchar(10), без значения по умолчанию и может иметь одно из следующих значений.
| значение | Описание |
|---|---|
Auto_Fix |
Связывает запись пользователя в представлении системного каталога в sys.database_principals текущей базе данных с именем sql Server. Если имя входа с тем же именем не существует, создается имя. Проверьте результат инструкции Auto_Fix , чтобы убедиться, что правильная ссылка на самом деле сделана. Избегайте использования Auto_Fix в ситуациях, чувствительных к безопасности.При использовании Auto_Fixнеобходимо указать @UserNamePattern и @Password, если имя входа еще не существует, в противном случае необходимо указать @UserNamePattern, но @Password игнорируется. @LoginName должно бытьNULL. @UserNamePattern должен быть допустимым пользователем в текущей базе данных. Имя входа не может сопоставить другого пользователя с ним. |
Report |
Выводит список пользователей и соответствующих идентификаторов безопасности (SID) в текущей базе данных, которые не связаны с каким-либо именем входа. @UserNamePattern, @LoginName и @Password должны быть NULL указаны или не указаны.Чтобы заменить параметр отчета запросом с помощью системных таблиц, сравните записи, приведенные в sys.server_prinicpals sys.database_principalsзаписях. |
Update_One |
Связывает указанные @UserNamePattern в текущей базе данных с существующим @LoginName SQL Server. необходимо указать @UserNamePattern и @LoginName. @Password должен быть NULL указан или не указан. |
[ @UserNamePattern = ] N'UserNamePattern'
Имя пользователя в текущей базе данных. @UserNamePattern имеет имя sysname с значением по умолчаниюNULL.
[ @LoginName = ] N'LoginName'
Имя имени входа SQL Server. @LoginName — sysname с значением по умолчаниюNULL.
[ @Password = ] N'Пароль
Пароль, назначенный новому имени входа SQL Server, созданному путем Auto_Fixуказания. @Password — sysname и не может бытьNULL. Если соответствующее имя входа уже существует, пользователь и имя входа сопоставляются и @Password игнорируются. Если соответствующее имя входа не существует, sp_change_users_login создает новое имя входа SQL Server и назначает @Password в качестве пароля для нового имени входа.
Внимание
Всегда используйте надежный пароль.
Значения кода возврата
0 (успешно) или 1 (сбой).
Результирующий набор
| Имя столбца | Тип данных | Description |
|---|---|---|
UserName |
sysname | Имя пользователя базы данных. |
UserSID |
varbinary(85) | Идентификатор защиты пользователя. |
Замечания
Используется sp_change_users_login для связывания пользователя базы данных в текущей базе данных с именем входа SQL Server. Если имя входа для пользователя изменяется, используйте sp_change_users_login для связывания пользователя с новым именем входа без потери разрешений пользователя. Новый @LoginName не может быть, и @UserNamePattern не может быть sadboили guestпользователемINFORMATION_SCHEMA.
sp_change_users_login Нельзя использовать для сопоставления пользователей базы данных с субъектами, сертификатами или асимметричными ключами windows.
sp_change_users_login нельзя использовать с именем входа SQL Server, созданным из субъекта Windows или пользователем, созданным с помощью CREATE USER WITHOUT LOGIN.
sp_change_users_login невозможно выполнить в рамках определяемой пользователем транзакции.
Разрешения
Требуется членство в предопределенной роли базы данных db_owner. Параметр может указывать Auto_Fix только члены предопределенных ролей сервера sysadmin.
Примеры
Примеры кода Transact-SQL в этой статье используют AdventureWorks2022 базу данных или AdventureWorksDW2022 пример базы данных, которую можно скачать с домашней страницы примеров и проектов сообщества Microsoft SQL Server.
А. Отображение отчета текущего пользователя для сопоставления входа
Следующий пример производит отчет по пользователям в текущей базе данных и их идентификаторам защиты (SIDs).
EXEC sp_change_users_login 'Report';
B. Сопоставление пользователя базы данных с новым именем входа SQL Server
В следующем примере пользователь базы данных связан с новым именем входа SQL Server. Пользователь базы данных MB-Sales, который сначала был сопоставлен с другим именем входа, будет повторно сопоставлен с именем входа MaryB.
--Create the new login.
CREATE LOGIN MaryB WITH PASSWORD = '982734snfdHHkjj3';
GO
--Map database user MB-Sales to login MaryB.
USE AdventureWorks2022;
GO
EXEC sp_change_users_login 'Update_One', 'MB-Sales', 'MaryB';
GO
C. Автоматическое сопоставление пользователя с именем входа и создание нового имени входа при необходимости
В следующем примере показано, как сопоставить Auto_Fix существующего пользователя с именем входа или создать имя входа SQL Server, который является паролемB3r12-3x$098f6, если имя входа Mary Mary не существует.
USE AdventureWorks2022;
GO
EXEC sp_change_users_login 'Auto_Fix', 'Mary', NULL, 'B3r12-3x$098f6';
GO