Artigo
04/01/2012

sp_addserver (Transact-SQL)

Define o nome da instância local de SQL Server. Este procedimento armazenado também define um servidor remoto.

Observação
A funcionalidade de servidor remoto será removida na próxima versão de SQL Server. Para definir servidores vinculados, use sp_addlinkedserver.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

sp_addserver [ @server = ] 'server' 
     [ , [ @local= ] 'local' ] 
     [ , [ @duplicate_ok = ] 'duplicate_OK' ]

Argumentos

[ @server = ] 'server'
É o nome do servidor. Os nomes de servidor devem ser exclusivos e seguir as regras de nomes do computador do Windows Microsoft, embora não sejam permitidos espaços. server é sysname, sem padrão.

Quando diversas instâncias de SQL Server estão instaladas em um computador, uma instância funciona como se estivesse em um servidor separado. Especifique uma instância nomeada recorrendo a server como servername\instancename.
[ @local = ] 'LOCAL'
Especifica se o servidor que está sendo adicionado é local ou remoto. @local é varchar(10), com padrão NULL. Especificar @local como LOCAL define @server como o nome do servidor local e faz com que a função @@SERVERNAME retorne o valor de server.

A instalação do SQL Server define esta variável como o nome do computador durante a instalação. Recomendamos que o nome não seja alterado. Por padrão, o nome do computador é o modo pelo qual os usuários se conectam a uma instância de SQL Server sem necessidade de configuração adicional.

A definição local só entra em vigor depois que o servidor é desligado e reiniciado. Apenas um servidor local pode ser definido em cada servidor.
[ @duplicate_ok = ] 'duplicate_OK'
Especifica se um nome de servidor duplicado é permitido. @ duplicate_OK é varchar(13), com um padrão de NULL. @ duplicate_OK só pode ter o valor duplicate_OK ou NULL. Se duplicate_OK for especificado e o nome de servidor que está sendo adicionado já existir, nenhum erro será apontado. Se os parâmetros nomeados não forem usados, @ local deve ser especificado.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

Para executar um procedimento armazenado em um servidor remoto (chamadas de procedimento remoto) que está executando uma versão anterior de SQL Server, adicione o servidor remoto usando sp_addserver. Para executar um procedimento armazenado ou qualquer consulta distribuída em um servidor remoto que está executando a versão 7.0 ou uma versão posterior de SQL Server, use sp_addlinkedserver para adicionar o servidor.

Para definir ou desmarcar opções de servidor, use sp_serveroption.

sp_addserver não pode ser usado em uma transação definida pelo usuário.