• Artigo

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.

ObservaçãoObservação

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.

Ícone de vínculo de tópicoConvenções de 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 nenhum 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. Ele é adicionado usando sp_addserver. Quando usuários no remoteserver se conectam ao servidor local que possui 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 de procedimento remoto.

  • [ @loginame = ] 'login'
    É a ID de logon do usuário na instância do SQL Server. login é sysname, com um padrão NULL. loginjá 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 de logon do usuário no servidor remoto. remote_name é sysname, com um padrão NULL. remote_name deve existir no 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

Somente membros das funções de servidor fixas 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';