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.

Icono de vínculo a temas 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 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 servername\instancename.

  • [ @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 ACCOUNTS la entrada del Motor de base de datos para el nombre del equipo que hospeda SQL Server.

sp_addserver 'ACCOUNTS', 'local';

Vea también

Tasks

Cambiar el nombre de un equipo que hospeda una instancia independiente de SQL Server

Referencia

sp_addlinkedserver (Transact-SQL)

sp_dropserver (Transact-SQL)

sp_helpserver (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)

Procedimientos almacenados de seguridad (Transact-SQL)