sp_addserver (Transact-SQL)

 

Define el nombre de la instancia local de SQL Server. Cuando se cambia el nombre del equipo que hospeda SQL Server, use sp_addserver para informar a la instancia de Motor de base de datos de SQL Server del nuevo nombre del equipo. Este procedimiento debe ejecutarse en todas las instancias del Motor de base de datos hospedado en el equipo. No se puede cambiar el nombre de instancia del Motor de base de datos. Para cambiar el nombre de instancia de una instancia con nombre, instale una instancia nueva con el nombre deseado, desasocie los archivos de base de datos de la instancia antigua, asocie las bases de datos a la nueva instancia y quite la antigua instancia. Como alternativa, puede crear un nombre de alias de cliente en el equipo cliente, redirigir la conexión a un servidor y nombre de instancia diferentes o a la combinación servidor:puerto sin cambiar el nombre de la instancia en el equipo servidor.

Se aplica a: SQL Server (SQL Server 2008 a través de la versión actual).

Convenciones de sintaxis de Transact-SQL

Sintaxis

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

Argumentos

• [ @server = ] 'server'
  Es el nombre del servidor. Los nombres de los servidores tienen que ser únicos y cumplir las reglas para los nombres de equipo de Microsoft Windows, aunque no se permiten espacios.server es de tipo sysname y no tiene ningún valor predeterminado.

  Cuando se instalan varias instancias de SQL Server en un equipo, una instancia opera como si estuviera en un servidor independiente. Especifique una instancia con nombre mediante una referencia a server como nombreDeServidor\nombreDeInstancia.

• [ @local =] 'LOCAL'
  Especifica el servidor que se va a agregar como servidor local.@local es de tipo varchar(10) y su valor predeterminado es NULL. Si se especifica @local como LOCAL, se define @server como el nombre del servidor local y la función @@SERVERNAME devuelve el valor de server.

  El programa de instalación de SQL Server establece esta variable en el nombre del equipo durante la instalación. De manera predeterminada, el nombre del equipo es la forma en que los usuarios se conectan a una instancia de SQL Server sin requerir ninguna configuración adicional.

  La definición local solo surte efecto después de reiniciarse el Motor de base de datos. Solo puede definirse un servidor local en cada instancia del Motor de base de datos.

• [ @duplicate_ok = ] 'duplicate_OK'
  Especifica si se permiten nombres de servidor duplicados.@duplicate_OK es de tipo varchar(13) y su valor predeterminado es NULL.@duplicate_OK solo puede tener el valor duplicate_OK o NULL. Si se especifica duplicate_OK y el nombre del servidor que se va agregar ya existe, no se produce ningún error. Si no se utilizan parámetros con nombre, se debe especificar @local.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

Para establecer o borrar opciones del servidor, utilice sp_serveroption.

sp_addserver no se puede utilizar en una transacción definida por el usuario.

Si se usa sp_addserver, se interrumpe la acción de agregar un servidor remoto. En su lugar, utilice sp_addlinkedserver.

Permisos

Debe pertenecer al rol fijo de servidor setupadmin.

Ejemplos

En el ejemplo siguiente se cambia a Motor de base de datos la entrada del SQL Server para el nombre del equipo que hospeda ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';

Vea también

Cambiar el nombre de un equipo que hospeda una instancia independiente de SQL Server
sp_addlinkedserver (Transact-SQL)
sp_dropserver (Transact-SQL)
sp_helpserver (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)
Procedimientos almacenados de seguridad (Transact-SQL)