sp_addremotelogin (Transact-SQL)
Aggiunge un nuovo ID di accesso remoto nel server locale. Ciò consente ai server remoti di connettersi ed eseguire chiamate di procedure remote.
Importante
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 non appena possibile le applicazioni in cui è attualmente implementata. Utilizzare i server collegati e le stored procedure per i server collegati in alternativa.
Si applica a: SQL Server (da SQL Server 2008 a versione corrente). |
.gif "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, su tutti gli utenti di remoteserver viene eseguito il mapping ad account di accesso esistenti aventi lo stesso nome nel server locale. Il server deve essere noto al server locale. Viene aggiunto tramite la funzione 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 inizia la chiamata RPC (Remote Procedure Call).[ @loginame = ] 'login'
ID dell'account di accesso dell'utente nell'istanza locale di SQL Server. login è di tipo sysname e il valore predefinito è NULL. login* *deve essere già presente nell'istanza locale di SQL Server. Se si specifica login, su tutti gli utenti di remoteserver viene eseguito il mapping 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 dell'account 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, sull'utente remote_name viene eseguito il mapping 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.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
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.
Esempi
A.Mapping uno-a-uno
Nell'esempio seguente viene eseguito il mapping dei nomi remoti 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
Riferimento
sp_addlinkedsrvlogin (Transact-SQL)
sp_dropremotelogin (Transact-SQL)
sp_helpremotelogin (Transact-SQL)