Condividi tramite

  • Articolo

sp_addserver (Transact-SQL)

Definisce il nome dell'istanza locale di SQL Server. Questa stored procedure definisce inoltre un server remoto.

[!NOTA]

La funzionalità del server remoto verrà eliminata a partire dalla prossima versione di SQL Server. Per definire i server collegati, utilizzare sp_addlinkedserver in alternativa.

Icona di collegamento a un argomentoConvenzioni 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 tuttavia 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 nomeserver\nomeistanza.

  • [ @local = ] 'LOCAL'
    Specifica se il server che viene aggiunto è locale o remoto. @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 di server.

    Durante l'installazione di SQL Server questa variabile viene impostata sul nome del computer. È consigliabile non modificare tale nome in quanto, per impostazione predefinita, il nome del computer consente agli utenti di connettersi a SQL Server senza ulteriori operazioni di configurazione.

    La definizione locale diventa attiva solo dopo l'arresto e il riavvio del server. È possibile definire un solo server locale in ogni server.

  • [ @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 eseguire una stored procedure in un server remoto (chiamate di procedure remote) che esegue una versione precedente di SQL Server, aggiungere il server remoto tramite sp_addserver. Per eseguire una stored procedure o qualsiasi query distribuita in un server remoto che esegue SQL Server 7.0 o versioni successive, utilizzare la stored procedure sp_addlinkedserver per aggiungere il server.

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.

Autorizzazioni

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

Esempi

Nell'esempio seguente viene creata una voce per il server remoto ACCOUNTS nel server locale.

sp_addserver 'ACCOUNTS';