sp_addremotelogin (Transact-SQL)

Articolo
12/15/2008

Aggiunge un nuovo ID di accesso remoto nel server locale. Ciò consente ai server remoti di connettersi ed eseguire chiamate di procedure remote.

[!NOTA] Questa funzionalità verrà rimossa a partire dalla prossima versione di Microsoft SQL Server. Non utilizzare questa funzionalità in un nuovo progetto di sviluppo e modificare appena possibile le applicazioni in cui questa funzionalità viene utilizzata. Utilizzare i server collegati e le stored procedure per i server collegati in alternativa.

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

Sintassi

sp_addremotelogin [ @remoteserver = ] 'remoteserver' 
     [ , [ @loginame = ] 'login' ] 
          [ , [ @remotename = ] 'remote_name' ]

Argomenti

[ @remoteserver = ] 'remoteserver'
Nome del server remoto a cui fa riferimento l'account di accesso remoto. remoteserver è di tipo sysname e non prevede alcun valore predefinito. Se si specifica solo remoteserver, tutti gli utenti di remoteserver vengono mappati ad account di accesso esistenti aventi lo stesso nome nel server locale. Il server deve essere noto al server locale. Il server viene aggiunto tramite sp_addserver. Quando per eseguire una stored procedure remota gli utenti di remoteserver si connettono al server locale in cui SQL Server è in esecuzione, utilizzano l'account di accesso locale corrispondente al proprio account di accesso in remoteserver. remoteserver è il server che inizializza la chiamata di procedura remota.

[ @loginame = ] 'login'
ID di accesso dell'utente nell'istanza locale di SQL Server. login è di tipo sysname e il valore predefinito è NULL. login deve esistere già nell'istanza locale di SQL Server. Se si specifica login, tutti gli utenti di remoteserver vengono mappati a tale account di accesso locale specifico. Gli utenti di remoteserver, quando si connettono all'istanza locale di SQL Server per eseguire una stored procedure remota, utilizzano l'account di accesso specificato tramite login.

[ @remotename = ] 'remote_name'
ID di accesso dell'utente nel server remoto. remote_name è di tipo sysname e il valore predefinito è NULL. remote_name deve esistere in remoteserver. Se si specifica remote_name, l'utente remote_name viene mappato all'account login nel server locale. Se remote_name in remoteserver si connette all'istanza locale di SQL Server per eseguire una stored procedure remota, utilizza l'account di accesso specificato tramite login. L'ID di accesso definito da remote_name può essere diverso dall'ID di accesso nel server remoto, ovvero login.

Osservazioni

Per eseguire query distribuite, utilizzare sp_addlinkedsrvlogin.

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

Autorizzazioni

Solo i membri dei ruoli predefiniti del server sysadmin e securityadmin possono eseguire sp_addremotelogin.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

A. Mapping uno-a-uno

Nell'esempio seguente i nomi remoti vengono mappati ai nomi locali quando nel server remoto ACCOUNTS e in quello locale sono disponibili gli stessi account di accesso.

EXEC sp_addremotelogin 'ACCOUNTS';

B. Mapping molti-a-uno

Nell'esempio seguente viene creata una voce per mappare tutti gli utenti del server remoto ACCOUNTS all'ID di accesso locale Albert.

EXEC sp_addremotelogin 'ACCOUNTS', 'Albert';

C. Utilizzo del mapping uno-a-uno esplicito

Nell'esempio seguente un account di accesso dell'utente remoto Chris nel server remoto ACCOUNTS viene mappato all'utente locale salesmgr.

EXEC sp_addremotelogin 'ACCOUNTS', 'salesmgr', 'Chris';

Vedere anche

Condividi tramite