sp_addremotelogin (T-SQL)

  • Artikel

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.

Konvensi sintaks transact-SQL

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 Albertmasuk 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 salesmgrlokal .

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

Konten terkait