sp_addserver (Transact-SQL)

Aplica-se a: simSQL Server (todas as versões compatíveis)

Define o nome da instância local do SQL Server. Quando o computador que hospeda o SQL Server for renomeado, use sp_addserver para informar a instância do Mecanismo de Banco de Dados do SQL Server nome do novo computador. 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.

Ícone de link do tópico Convenções da 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 fazendo referência ao servidor como nomedoservidor \ NomedaInstância.

[ @local = ] 'LOCAL' Especifica que o servidor que está sendo adicionado como um servidor local. o @ local é varchar (10), com um padrão de NULL. Especificar @ local como local define o @ servidor como o nome do servidor local e faz com que a @SERVERNAME função @ retorne o valor do servidor.

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 nulo. Se duplicate_OK for especificado e o nome do servidor que está sendo adicionado já existir, nenhum erro será gerado. Se os parâmetros nomeados não forem usados, o @ local deverá ser especificado.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Comentários

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

sp_addserver não pode ser usada dentro de 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.

O uso de sp_addserver para alterar o nome do servidor local pode causar efeitos indesejados ou configurações sem suporte ao usar grupos de disponibilidade ou replicação.

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 de Stand-Alone do SQL Server sp_addlinkedserver (transact-SQL) sp_dropserver (transact-SQL) sp_helpserver (o transact-SQL) procedimentos armazenados do sistema ( procedimentos armazenados de segurança do SQL)(o transact-SQL)