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

SI APPLICA A: sìSQL Server noDatabase SQL di Azure noAzure SQL Data Warehouse noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Definisce il nome dell'istanza locale di SQL ServerSQL Server.Defines the name of the local instance of SQL ServerSQL Server. Quando il computer che ospita SQL ServerSQL Server viene rinominato, usare sp_addserver per indicare all'istanza del Motore di database di SQL ServerSQL Server Database Engine del nome del nuovo computer.When the computer hosting SQL ServerSQL Server is renamed, use sp_addserver to inform the instance of the Motore di database di SQL ServerSQL Server Database Engine of the new computer name. Questa routine deve essere eseguita in tutte le istanze del Motore di databaseDatabase Engine ospitate nel computer.This procedure must be executed on all instances of the Motore di databaseDatabase Engine hosted on the computer. Non è possibile modificare il nome dell'istanza del Motore di databaseDatabase Engine .The instance name of the Motore di databaseDatabase Engine cannot be changed. Per modificare il nome di un'istanza denominata, installare una nuova istanza con il nome desiderato, scollegare i file di database dall'istanza precedente, collegare i database alla nuova istanza ed eliminare l'istanza precedente.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. In alternativa, è possibile creare un nome alias del client nel computer client, reindirizzando la connessione a una combinazione diversa di server e nome di istanza o server:port senza modificare il nome dell'istanza nel computer server.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.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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

ArgomentiArguments

[ @server = ] 'server' È il nome del server.[ @server = ] 'server' Is the name of the server. I nomi di server devono essere univoci e conformi alle regole per i nomi di computer di MicrosoftMicrosoft Windows. Gli spazi non sono consentiti.Server names must be unique and follow the rules for MicrosoftMicrosoft Windows computer names, although spaces are not allowed. server è di tipo sysnamee non prevede alcun valore predefinito.server is sysname, with no default.

Se in un computer sono installate più istanze di SQL ServerSQL Server , un'istanza funziona come se si trovasse in un server distinto.When multiple instances of SQL ServerSQL Server are installed on a computer, an instance operates as if it is on a separate server. Specificare un'istanza denominata tramite un riferimento a server come nomeserver\nomeistanza.Specify a named instance by referring to server as servername\instancename.

[ @local = ] 'LOCAL' Specifica che il server che viene aggiunto come server locale.[ @local = ] 'LOCAL' Specifies that the server that is being added as a local server. @local** viene varchar (10) , con un valore predefinito è NULL.@local** is varchar(10), with a default of NULL. Che specifica **@local** come locale definisce **@server** come nome del server locale e le cause di @@SERVERNAME funzione per restituire il valore dei 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.

Durante l'installazione di SQL ServerSQL Server questa variabile viene impostata sul nome del computer.SQL ServerSQL Server Setup sets this variable to the computer name during installation. Per impostazione predefinita, il nome del computer consente agli utenti di connettersi a un'istanza di SQL ServerSQL Server senza ulteriori operazioni di configurazione.By default, the computer name is the way users connect to an instance of SQL ServerSQL Server without requiring additional configuration.

La definizione locale diventa effettiva solo dopo il riavvio del Motore di databaseDatabase Engine .The local definition takes effect only after the Motore di databaseDatabase Engine is restarted. È possibile definire un solo server locale in ogni istanza del Motore di databaseDatabase Engine.Only one local server can be defined in each instance of the Motore di databaseDatabase Engine.

[ @duplicate_ok = ] 'duplicate_OK' Specifica se è consentito un nome di server duplicato.[ @duplicate_ok = ] 'duplicate_OK' Specifies whether a duplicate server name is allowed. @duplicate_OK** viene varchar(13) , con un valore predefinito è NULL.@duplicate_OK** is varchar(13), with a default of NULL. @duplicate_OK** può avere solo il valore duplicate_OK o NULL.@duplicate_OK** can only have the value duplicate_OK or NULL. Se duplicate_OK specificato e il nome del server da aggiungere già esiste, viene generato alcun errore.If duplicate_OK is specified and the server name that is being added already exists, no error is raised. Se non si utilizzano parametri denominati, **@local** deve essere specificato.If named parameters are not used, **@local** must be specified.

Valori restituitiReturn Code Values

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

NoteRemarks

Per impostare o deselezionare le opzioni server, usare sp_serveroption.To set or clear server options, use sp_serveroption.

sp_addserver non può essere utilizzata in una transazione definita dall'utente.sp_addserver cannot be used inside a user-defined transaction.

Usando sp_addserver per aggiungere un server remoto non è più disponibile.Using sp_addserver to add a remote server is discontinued. Usare sp_addlinkedserver in alternativa.Use sp_addlinkedserver instead.

PermissionsPermissions

È richiesta l'appartenenza al ruolo predefinito del server setupadmin .Requires membership in the setupadmin fixed server role.

EsempiExamples

Nell'esempio seguente la voce del Motore di databaseDatabase Engine per il nome del computer che ospita SQL ServerSQL Server viene modificata in ACCOUNTS.The following example changes the Motore di databaseDatabase Engine entry for the name of the computer hosting SQL ServerSQL Server to ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';  

Vedere ancheSee Also

Rinominare un Computer che ospita un'istanza autonoma di 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 (Transact-SQL) sp_helpserver (Transact-SQL)
Stored procedure di sistema (Transact-SQL) System Stored Procedures (Transact-SQL)
Stored procedure di sicurezza (Transact-SQL)Security Stored Procedures (Transact-SQL)