sp_addserver (Transact-SQL)sp_addserver (Transact-SQL)

ESTE TEMA SE APLICA A:síSQL Server (a partir de 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noAlmacenamiento de datos paralelos THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Define el nombre de la instancia local de SQL ServerSQL Server.Defines the name of the local instance of SQL ServerSQL Server. Cuando el equipo que hospeda SQL ServerSQL Server es cambiar el nombre, utilice sp_addserver para informar a la instancia de la Motor de base de datos de SQL ServerSQL Server Database Engine del nuevo nombre de equipo.When the computer hosting SQL ServerSQL Server is renamed, use sp_addserver to inform the instance of the Motor de base de datos de SQL ServerSQL Server Database Engine of the new computer name. Este procedimiento debe ejecutarse en todas las instancias del Motor de base de datosDatabase Engine hospedado en el equipo.This procedure must be executed on all instances of the Motor de base de datosDatabase Engine hosted on the computer. El nombre de instancia de la Motor de base de datosDatabase Engine no se puede cambiar.The instance name of the Motor de base de datosDatabase Engine cannot be changed. 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.To change the instance name of a named instance, install a new instance with the desired name, detach the database files from old instance, attach the databases to the new instance and drop the old instance. 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.Alternatively, you can create a client alias name on the client computer, redirecting the connection to different server and instance name or server:port combination without changing the name of the instance on the server computer.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax


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

ArgumentosArguments

[ @server = ] 'server'[ @server = ] 'server'
Es el nombre del servidor.Is the name of the server. Los nombres de los servidores tienen que ser únicos y cumplir las reglas para los nombres de equipo de MicrosoftMicrosoft Windows, aunque no se permiten espacios.Server names must be unique and follow the rules for MicrosoftMicrosoft Windows computer names, although spaces are not allowed. server es de tipo sysnamey no tiene ningún valor predeterminado.server is sysname, with no default.

Cuando varias instancias de SQL ServerSQL Server se instalan en un equipo, una instancia opera como si estuviera en un servidor independiente.When multiple instances of SQL ServerSQL Server are installed on a computer, an instance operates as if it is on a separate server. Especifique una instancia con nombre mediante una referencia a server como nombreDeServidor ombreDeInstancia.Specify a named instance by referring to server as servername\instancename.

[ @local = ] 'LOCAL'[ @local = ] 'LOCAL'
Especifica el servidor que se va a agregar como servidor local.Specifies that the server that is being added as a local server. @local es varchar (10), su valor predeterminado es null.@local is varchar(10), with a default of NULL. Especificar @local como LOCAL define @server como el nombre del servidor local y el @@SERVERNAME función para devolver el valor de server.Specifying @local as LOCAL defines @server as the name of the local server and causes the @@SERVERNAME function to return the value of server.

El programa de instalación de SQL ServerSQL Server establece esta variable en el nombre del equipo durante la instalación. SQL ServerSQL Server Setup sets this variable to the computer name during installation. De forma predeterminada, el nombre del equipo es la forma, los usuarios se conectan a una instancia de SQL ServerSQL Server sin requerir ninguna configuración adicional.By default, the computer name is the way users connect to an instance of SQL ServerSQL Server without requiring additional configuration.

La definición local solo surte efecto después de reiniciarse el Motor de base de datosDatabase Engine.The local definition takes effect only after the Motor de base de datosDatabase Engine is restarted. Solo puede definirse un servidor local en cada instancia del Motor de base de datosDatabase Engine.Only one local server can be defined in each instance of the Motor de base de datosDatabase Engine.

[ @duplicate_ok = ] 'duplicate_OK'[ @duplicate_ok = ] 'duplicate_OK'
Especifica si se permiten nombres de servidor duplicados.Specifies whether a duplicate server name is allowed. @duplicate_OK es varchar (13), su valor predeterminado es null.@duplicate_OK is varchar(13), with a default of NULL. @duplicate_OK sólo puede tener el valor duplicate_OK o NULL.@duplicate_OK can only have the value duplicate_OK or NULL. Si duplicate_OK se especifica y el nombre del servidor que se va a agregar ya existe, se produce ningún error.If duplicate_OK is specified and the server name that is being added already exists, no error is raised. Si no se utilizan parámetros con nombre, @local debe especificarse.If named parameters are not used, @local must be specified.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

ComentariosRemarks

Para establecer o borrar opciones del servidor, utilice sp_serveroption.To set or clear server options, use sp_serveroption.

sp_addserver no se puede usar dentro de una transacción definida por el usuario.sp_addserver cannot be used inside a user-defined transaction.

Usar sp_addserver para agregar un servidor remoto ya no está disponible.Using sp_addserver to add a remote server is discontinued. Use en su lugar sp_addlinkedserver .Use sp_addlinkedserver instead.

PermissionsPermissions

Debe pertenecer al rol fijo de servidor setupadmin .Requires membership in the setupadmin fixed server role.

EjemplosExamples

En el ejemplo siguiente se cambia a ACCOUNTS la entrada del Motor de base de datosDatabase Engine para el nombre del equipo que hospeda SQL ServerSQL Server.The following example changes the Motor de base de datosDatabase Engine entry for the name of the computer hosting SQL ServerSQL Server to ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';  

Vea tambiénSee Also

Cambiar el nombre de un equipo que hospeda una instancia independiente de SQL Server Rename a Computer that Hosts a Stand-Alone Instance of SQL Server
sp_addlinkedserver (Transact-SQL) sp_addlinkedserver (Transact-SQL)
sp_dropserver (Transact-SQL) sp_dropserver (Transact-SQL)
sp_helpserver & #40; Transact-SQL & #41; sp_helpserver (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
Procedimientos almacenados de seguridad (Transact-SQL)Security Stored Procedures (Transact-SQL)