Compartilhar via


sp_addserver (Transact-SQL)

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

ObservaçãoObservaçã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ópicoConvençõ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.

Permissões

Exige uma associação na função de servidor fixa setupadmin.

Exemplos

O exemplo a seguir cria uma entrada para o servidor remoto ACCOUNTS no servidor local.

sp_addserver 'ACCOUNTS';