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

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

Define el nombre de la instancia local de SQL ServerSQL Server.Defines the name of the local instance of SQL ServerSQL Server. Cuando se cambie el nombre del equipo SQL ServerSQL Server que hospeda, utilice sp_addserver para informar a la instancia del Motor de base de datos de SQL ServerSQL Server Database Engine nombre del nuevo 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. No se puede cambiar el nombre de instancia del Motor de base de datosDatabase Engine .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' Es el nombre del servidor.[ @server = ] 'server' 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 sysname y no tiene ningún valor predeterminado.server is sysname, with no default.

Cuando se instalan varias instancias de SQL ServerSQL Server 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 haciendo referencia al servidor como nombredeservidor\nombredeinstancia.Specify a named instance by referring to server as servername\instancename.

[ @local = ] 'LOCAL' Especifica que el servidor que se va a agregar como servidor local.[ @local = ] 'LOCAL' Specifies that the server that is being added as a local server. @ local es VARCHAR (10) y su valor predeterminado es NULL.@local is varchar(10), with a default of NULL. Al especificar @ local como local , se define @ Server como el nombre del servidor local y se hace que la @SERVERNAME función @ devuelva 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 manera predeterminada, el nombre del equipo es la forma en que 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' Especifica si se permite un nombre de servidor duplicado.[ @duplicate_ok = ] 'duplicate_OK' Specifies whether a duplicate server name is allowed. @ duplicate_OK es de tipo VARCHAR (13) y su valor predeterminado es NULL.@duplicate_OK is varchar(13), with a default of NULL. @ duplicate_OK solo puede tener el valor duplicate_OK o null.@duplicate_OK can only have the value duplicate_OK or NULL. Si se especifica duplicate_OK y el nombre del servidor que se va a agregar ya existe, no se genera 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, se debe especificar @ local .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)

ObservacionesRemarks

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

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

El uso de sp_addserver para agregar un servidor remoto es discontinuo.Using sp_addserver to add a remote server is discontinued. Use en su lugar sp_addlinkedserver.Use sp_addlinkedserver instead.

PermisosPermissions

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

EjemplosExamples

En el ejemplo siguiente se cambia a Motor de base de datosDatabase Engine la entrada del SQL ServerSQL Server para el nombre del equipo que hospeda ACCOUNTS.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';

Consulte tambiénSee Also

Cambiar el nombre de un equipo que hospeda una instancia de Stand-Alone 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)Rename a Computer that Hosts a Stand-Alone Instance of SQL Server sp_addlinkedserver (Transact-SQL) sp_dropserver (Transact-SQL) sp_helpserver (Transact-SQL) System Stored Procedures (Transact-SQL) Security Stored Procedures (Transact-SQL)