sp_addremotelogin (Transact-SQL)
Adiciona uma nova ID de logon remoto no servidor local. Isso permite que os servidores remotos se conectem e executem chamadas de procedimento remoto.
.gif "Observação importante") Importante |
|---|
Esse recurso será removido na próxima versão do Microsoft SQL Server. Não utilize esse recurso em desenvolvimentos novos e modifique, assim que possível, os aplicativos que atualmente o utilizam. Use procedimentos armazenados de servidor vinculado e servidores vinculados em vez disso. |
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
sp_addremotelogin [ @remoteserver = ] 'remoteserver'
[ , [ @loginame = ] 'login' ]
[ , [ @remotename = ] 'remote_name' ]
Argumentos
[ @remoteserver = ] 'remoteserver'
É o nome do servidor remoto ao qual o logon remoto se aplica. remoteserver é sysname, sem padrão. Se somente remoteserver for especificado, todos os usuários no remoteserver são mapeados para esse os logons existentes de mesmo nome no servidor local. O servidor deve ser conhecido do servidor local. Isso é adicionado usando sp_addserver. Quando os usuários do remoteserver se conectam ao servidor local que está executando o SQL Server para executar um procedimento armazenado remoto, eles se conectam com o logon local que corresponde ao seu próprio logon no remoteserver. remoteserver é o servidor que inicia a chamada do procedimento remoto.[ @loginame = ] 'login'
É a ID do logon do usuário na instância local do SQL Server. login é sysname, com um padrão de NULL. login* *já deve existir na instância local do SQL Server. Se login for especificado, todos os usuários no remoteserver serão mapeados para esse logon local específico. Quando usuários no remoteserver se conectam à instância local do SQL Server para executar um procedimento armazenado remoto, eles se conectam como login.[ @remotename = ] 'remote_name'
É a ID do logon do usuário no servidor remoto. remote_name é sysname, com um padrão de NULL. remote_name devem existir em remoteserver. Se remote_name for especificado, o remote_name de usuário específico será mapeado para login no servidor local. Quando usuários no remote_name no remoteserver se conecta à instância local do SQL Server para executar um procedimento armazenado remoto, ele se conecta como login. A ID de logon de remote_name pode ser diferente da ID de logon do servidor remoto, login.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
Para executar consultas distribuídas, use sp_addlinkedsrvlogin.
sp_addremotelogin não pode ser usado em uma transação definida pelo usuário.
Permissões
Apenas os membros da função de servidor fixa sysadmin e securityadmin podem executar sp_addremotelogin.
Exemplos
A.Mapeando um para um
O exemplo a seguir mapeia nomes remotos para nomes locais quando o servidor remoto ACCOUNTS e o servidor local usam os mesmos logons de usuário.
EXEC sp_addremotelogin 'ACCOUNTS';
B.Mapeando muitos para um
O exemplo a seguir cria uma entrada que mapeia todos os usuários do servidor remoto ACCOUNTS para a ID de logon local Albert.
EXEC sp_addremotelogin 'ACCOUNTS', 'Albert';
C.Usando um mapeamento um para um explícito
O exemplo a seguir mapeia um logon remoto de um usuário remoto Chris no servidor remoto ACCOUNTS para o usuário local salesmgr.
EXEC sp_addremotelogin 'ACCOUNTS', 'salesmgr', 'Chris';
Consulte também
Referência
sp_addlinkedsrvlogin (Transact-SQL)
sp_dropremotelogin (Transact-SQL)
sp_helpremotelogin (Transact-SQL)