sp_addserver (Transact-SQL)

 

Define o nome da instância local do SQL Server. Quando o computador que hospeda o SQL Server é renomeado, use sp_addserver para informar o novo nome do computador à instância do Mecanismo de Banco de Dados do SQL Server. Esse procedimento deve ser executado em todas as instâncias do Mecanismo de Banco de Dados hospedadas no computador. O nome da instância do Mecanismo de Banco de Dados não pode ser alterado. Para alterar o nome de instância de uma instância nomeada, instale uma nova instância com o nome desejado, desanexe os arquivos de bancos de dados da instância antiga, anexe os bancos de dados à nova instância e remova a instância antiga. Como alternativa, você pode criar um nome de alias de cliente no computador cliente, redirecionando a conexão para um nome de servidor e de instância diferente ou para uma combinação server:port sem alterar o nome da instância no computador do servidor.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual).

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 Microsoft Windows, 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 por meio de referência ao server como servername\instancename.

• [ @local = ] 'LOCAL'
  Especifica se o servidor que está sendo adicionado é um servidor local.@local é varchar(10), com um padrão de 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 essa variável como o nome do computador durante a instalação. Por padrão, o nome do computador é o modo como os usuários se conectam a uma instância do SQL Server sem necessidade de configuração adicional.

  A definição local entra em vigor apenas depois de o Mecanismo de Banco de Dados ser reiniciado. Apenas um servidor local pode ser definido em cada instância do Mecanismo de Banco de Dados.

• [ @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 deverá ser especificado.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

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

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

O uso de sp_addserver para adicionar um servidor remoto foi descontinuado. Em vez disso, use sp_addlinkedserver.

Permissões

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

Exemplos

O exemplo a seguir altera a entrada do Mecanismo de Banco de Dados para o nome do computador que hospeda o SQL Server para ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';

Consulte também

Renomear um computador que hospeda uma instância autônoma do SQL Server
sp_addlinkedserver (Transact-SQL)
sp_dropserver (Transact-SQL)
sp_helpserver (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
Procedimentos armazenados de segurança (Transact-SQL)