sp_addserver (Transact-SQL)

Definisce il nome dell'istanza locale di SQL Server. Quando viene rinominato il computer che ospita SQL Server, utilizzare sp_addserver per indicare all'istanza del Motore di database di SQL Server il nuovo nome computer. Questa routine deve essere eseguita in tutte le istanze del Motore di database ospitate nel computer. Non è possibile modificare il nome dell'istanza del Motore di database.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @server = ] 'server'
    Nome del server. I nomi di server devono essere univoci e conformi alle regole per i nomi di computer di Microsoft Windows. Gli spazi non sono consentiti. server è di tipo sysname e non prevede alcun valore predefinito.

    Se in un computer sono installate più istanze di SQL Server, un'istanza funziona come se si trovasse in un server distinto. Specificare un'istanza denominata tramite un riferimento a server nel formato servername\instancename.

  • [ @local = ] 'LOCAL'
    Specifica che il server viene aggiunto come server locale. @local è di tipo varchar(10) e il valore predefinito è NULL. Se si specifica @local come LOCAL, @server viene definito come nome del server locale e la funzione @@SERVERNAME restituisce il valore server.

    Durante l'installazione di SQL Server questa variabile viene impostata sul nome del computer. Per impostazione predefinita, il nome del computer consente agli utenti di connettersi a un'istanza di SQL Server senza ulteriori operazioni di configurazione.

    La definizione locale diventa effettiva solo dopo il riavvio del Motore di database. È possibile definire un solo server locale in ogni istanza del Motore di database.

  • [ @duplicate_ok = ] 'duplicate_OK'
    Specifica se è consentito utilizzare un nome di server duplicato. @duplicate_OK è di tipo varchar(13) e il valore predefinito è NULL. I possibili valori di @duplicate_OK sono duplicate_OK o NULL. Se si specifica duplicate_OK e il nome del server aggiunto esiste già, non viene generato alcun errore. Se non si utilizzano parametri denominati, è necessario specificare @local.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Osservazioni

Per selezionare o deselezionare le opzioni del server, utilizzare sp_serveroption.

La stored procedure sp_addserver non può essere utilizzata in una transazione definita dall'utente.

Non è più possibile utilizzare sp_addserver per aggiungere un server remoto. Utilizzare invece sp_addlinkedserver.

Autorizzazioni

È richiesta l'appartenenza al ruolo predefinito del server setupadmin.

Esempi

Nell'esempio seguente la voce del Motore di database per il nome del computer che ospita SQL Server viene modificata in ACCOUNTS.

sp_addserver 'ACCOUNTS', 'local';

Vedere anche

Attivitá

Rinominare un computer che ospita un'istanza autonoma di SQL Server

Riferimento

sp_addlinkedserver (Transact-SQL)

sp_dropserver (Transact-SQL)

sp_helpserver (Transact-SQL)

Stored procedure di sistema (Transact-SQL)

Stored procedure di sicurezza (Transact-SQL)