Compartir a través de

  • Artículo

sp_addserver (Transact-SQL)

Define el nombre de la instancia local de SQL Server. Este procedimiento almacenado también define un servidor remoto.

Nota

La funcionalidad del servidor remoto se quitará en la siguiente versión de SQL Server. Para definir servidores vinculados, utilice sp_addlinkedserver.

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

  • [ @local = ] 'LOCAL'
    Especifica si el servidor que se va a agregar es un servidor local o remoto. @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. Se recomienda no cambiar el nombre. 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 sólo tiene efecto después apagar y reiniciar el servidor. Sólo se puede definir un servidor local en cada servidor.

  • [ @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 sólo 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 ejecutar un procedimiento almacenado en un servidor remoto (llamadas a procedimiento remoto) en que se ejecute una versión anterior de SQL Server, agregue el servidor remoto mediante sp_addserver. Para ejecutar un procedimiento almacenado (o una consulta distribuida) en un servidor remoto que ejecute SQL Server versión 7.0 o posterior, utilice sp_addlinkedserver para agregar el servidor.

Para establecer o anular las opciones del servidor, utilice sp_serveroption.

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

Permisos

Debe pertenecer a la función fija de servidor setupadmin.

Ejemplos

En el siguiente ejemplo se crea una entrada para el servidor remoto ACCOUNTS en el servidor local.

sp_addserver 'ACCOUNTS';