sp_change_users_login (Transact-SQL)

Sintaxe

sp_change_users_login [ @Action = ] 'action' 
    [ , [ @UserNamePattern = ] 'user' ] 
    [ , [ @LoginName = ] 'login' ] 
    [ , [ @Password = ] 'password' ]
[;]

Argumentos

• [ @Action = ] 'action'
  Descreve a ação a ser executada pelo procedimento. action é varchar(10). action pode ter um dos valores a seguir.

  Valor	Descrição
  Auto_Fix	Vincula uma entrada de usuário na exibição do catálogo de sistema sys.database_principals no banco de dados atual a um logon de nome igual do SQL Server. Se ainda não existir um logon com o mesmo nome, ele será criado. Examine o resultado da instrução Auto_Fix para confirmar que o vínculo correto foi realmente estabelecido. Evite usar Auto_Fix em situações confidenciais de segurança. Ao usar Auto_Fix, especifique user e password se o logon ainda não existir; caso contrário, especifique user mas password será ignorado. login deve ser NULL. user deve ser um usuário válido no banco de dados atual. Não pode haver outro usuário mapeado para o logon.
  Report	Lista os usuários e o SID (identificador de segurança) correspondentes no banco de dados atual que não estão vinculados a nenhum logon. user, login e password devem ser NULL ou não especificados.
  Update_One	Vincula o user especificado no banco de dados atual a um login do SQL Server. user e login devem ser especificados. password deve ser NULL ou não especificada.

• [ @UserNamePattern = ] 'user'
  É o nome de um usuário do banco de dados atual. user é sysname, com um padrão de NULL.

• [ @LoginName = ] 'login'
  É o nome de um logon do SQL Server. login é sysname, com um padrão de NULL.

• [ @Password = ] 'password'
  É a senha atribuída a um novo logon do SQL Server, criado pela especificação de Auto_Fix. Se já existir um logon correspondente, o usuário e o logon serão mapeados e password será ignorada. Se não existir um logon correspondente, sp_change_users_login criará um novo logon do SQL Server e atribuirá password como a senha do novo logon. password é sysname e não deve ser NULL.

  Observação sobre segurança
  Use uma senha forte. Para obter mais informações, consulte Senhas fortes.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Comentários

Use sp_change_users_login para vincular um usuário do banco de dados atual a um logon do SQL Server. Se o logon do usuário for alterado, use sp_change_users_login para vinculá-lo ao novo logon sem perder as permissões de usuário. O novo login não pode ser sa, e o user não pode ser dbo, convidado ou um usuário do INFORMATION_SCHEMA.

Não é possível usar sp_change_users_login para mapear os usuários do banco de dados para entidades do nível do Windows, certificados ou chaves assimétricas.

sp_change_users_login não pode ser usado com um logon do SQL Server criado a partir de uma entidade do Windows ou com um usuário criado pelo uso de CREATE USER WITHOUT LOGIN.

Não é possível executar sp_change_users_login em uma transação definida pelo usuário.

Permissões

Requer associação à função de banco de dados fixa db_owner. Somente os membros da função de servidor fixa sysadmin podem especificar a opção Auto_Fix.

Exemplos

A. Mostrando um relatório do usuário atual para mapeamentos de logon

EXEC sp_change_users_login 'Report';

B. Mapeando um usuário de banco de dados para um novo logon do SQL Server

--Create the new login.
CREATE LOGIN MaryB WITH PASSWORD = '982734snfdHHkjj3';
GO
--Map database user MB-Sales to login MaryB.
USE AdventureWorks2008R2;
GO
EXEC sp_change_users_login 'Update_One', 'MB-Sales', 'MaryB';
GO

C. Mapeando automaticamente um usuário para um logon, criando um novo logon se necessário

USE AdventureWorks2008R2;
GO
EXEC sp_change_users_login 'Auto_Fix', 'Mary', NULL, 'B3r12-3x$098f6';
GO

Consulte também

Referência