sys.sp_addqreader_agent (Transact-SQL)

Berlaku untuk: SQL ServerAzure SQL Managed Instance

Menambahkan agen Pembaca Antrean untuk Distributor tertentu. Prosedur tersimpan ini dijalankan di Distributor pada database distribusi atau di Penerbit pada database publikasi.

Konvensi sintaks transact-SQL

Sintaks

sys.sp_addqreader_agent
    [ [ @job_login = ] N'job_login' ]
    [ , [ @job_password = ] N'job_password' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @frompublisher = ] frompublisher ]
[ ; ]

Argumen

[ @job_login = ] N'job_login'

Login untuk akun Windows tempat agen berjalan. @job_login adalah nvarchar(257), dengan default NULL. Akun Windows ini selalu digunakan untuk koneksi agen ke Distributor.

[ @job_password = ] N'job_password'

Kata sandi untuk akun Windows tempat agen berjalan. @job_password adalah sysname, tanpa default.

Penting

Jangan simpan informasi autentikasi dalam file skrip. Untuk keamanan terbaik, nama login dan kata sandi harus disediakan saat runtime.

[ @job_name = ] N'job_name'

Nama pekerjaan agen yang ada. @job_name adalah sysname, dengan default NULL. Parameter ini hanya ditentukan ketika agen dibuat menggunakan pekerjaan yang ada alih-alih pekerjaan yang baru dibuat (default).

[ @frompublisher = ] daripenerbit

Menentukan apakah prosedur sedang dijalankan di Publisher. @frompublisher adalah bit, dengan default .0

Nilai 1 berarti bahwa prosedur sedang dijalankan dari Publisher pada database publikasi.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

sp_addqreader_agent digunakan dalam replikasi transaksional.

sp_addqreader_agent harus dijalankan setidaknya sekali di Distributor yang mendukung pembaruan antrean setelah sp_adddistributiondb tetapi sebelum sp_addpublication.

Pekerjaan Agen Pembaca Antrean dihapus saat Anda menjalankan sp_dropdistributiondb.

Izin

Hanya anggota peran server tetap sysadmin yang dapat menjalankan sp_addqreader_agent.