sp_addremotelogin (T-SQL)
Berlaku untuk: SQL Server
Menambahkan ID masuk jarak jauh baru di server lokal. Ini memungkinkan server jarak jauh untuk menyambungkan dan menjalankan panggilan prosedur jarak jauh.
Penting
Fitur ini akan dihapus dalam versi SQL Server yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru, dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Gunakan server tertaut dan prosedur tersimpan server tertaut sebagai gantinya.
Sintaks
sp_addremotelogin
[ @remoteserver = ] N'remoteserver'
[ , [ @loginame = ] N'loginame' ]
[ , [ @remotename = ] N'remotename' ]
[ ; ]
Argumen
[ @remoteserver = ] N'remoteserver'
Nama server jarak jauh tempat masuk jarak jauh diterapkan. @remoteserver adalah sysname, tanpa default. Jika hanya @remoteserver yang ditentukan, semua pengguna di @remoteserver dipetakan ke login yang ada dengan nama yang sama di server lokal. Server harus diketahui oleh server lokal. Ini ditambahkan dengan menggunakan sp_addserver. Ketika pengguna di @remoteserver terhubung ke server lokal yang menjalankan SQL Server untuk menjalankan prosedur tersimpan jarak jauh, mereka terhubung sebagai login lokal yang cocok dengan login mereka sendiri di @remoteserver. @remoteserver adalah server yang memulai panggilan prosedur jarak jauh.
[ @loginame = ] N'loginame'
ID masuk pengguna pada instans lokal SQL Server. @loginame adalah sysname, dengan default NULL
. @loginame harus sudah ada pada instans lokal SQL Server. Jika @loginame ditentukan, semua pengguna di @remoteserver dipetakan ke login lokal tertentu. Ketika pengguna di @remoteserver terhubung ke instans lokal SQL Server untuk menjalankan prosedur tersimpan jarak jauh, mereka terhubung sebagai @loginame.
[ @remotename = ] N'remotename'
ID masuk pengguna di server jarak jauh. @remotename adalah sysname, dengan default NULL
. @remotename harus ada di @remoteserver. Jika @remotename ditentukan, @remotename pengguna tertentu dipetakan ke @loginame di server lokal. Ketika @remotename di @remoteserver terhubung ke instans lokal SQL Server untuk menjalankan prosedur tersimpan jarak jauh, ia terhubung sebagai @loginame. ID masuk @remotename dapat berbeda dari ID masuk di server jarak jauh, @loginame.
Mengembalikan nilai kode
0
(berhasil) atau 1
(kegagalan).
Keterangan
Untuk menjalankan kueri terdistribusi, gunakan sp_addlinkedsrvlogin
.
sp_addremotelogin
tidak dapat digunakan di dalam transaksi yang ditentukan pengguna.
Izin
Hanya anggota peran server tetap sysadmin dan securityadmin yang dapat menjalankan sp_addremotelogin
.
Contoh
J. Petakan satu ke satu
Contoh berikut memetakan nama jarak jauh ke nama lokal ketika server ACCOUNTS
jarak jauh dan server lokal memiliki login pengguna yang sama.
EXEC sp_addremotelogin 'ACCOUNTS';
B. Petakan banyak ke satu
Contoh berikut membuat entri yang memetakan semua pengguna dari server ACCOUNTS
jarak jauh ke ID Albert
masuk lokal .
EXEC sp_addremotelogin 'ACCOUNTS', 'Albert';
C. Menggunakan pemetaan satu-ke-satu eksplisit
Contoh berikut memetakan login jarak jauh dari pengguna Chris
jarak jauh di server ACCOUNTS
jarak jauh ke pengguna salesmgr
lokal .
EXEC sp_addremotelogin 'ACCOUNTS', 'salesmgr', 'Chris';