sp_addqreader_agent (Transact-SQL)
Applies to: SQL Server Azure SQL Managed Instance
Adds a Queue Reader agent for a given Distributor. This stored procedure is executed at the Distributor on the distribution database or at the Publisher on the publication database.
Transact-SQL syntax conventions
Syntax
sp_addqreader_agent
[ [ @job_login = ] N'job_login' ]
[ , [ @job_password = ] N'job_password' ]
[ , [ @job_name = ] N'job_name' ]
[ , [ @frompublisher = ] frompublisher ]
[ ; ]
Arguments
[ @job_login = ] N'job_login'
The login for the Microsoft Windows account under which the agent runs. @job_login is nvarchar(257), with a default of NULL
. This Windows account is always used for agent connections to the Distributor.
[ @job_password = ] N'job_password'
The password for the Windows account under which the agent runs. @job_password is sysname, with no default.
Important
Don't store authentication information in script files. For best security, login names and passwords should be supplied at runtime.
[ @job_name = ] N'job_name'
The name of an existing agent job. @job_name is sysname, with a default of NULL
. This parameter is only specified when the agent is created using an existing job instead of a newly created job (the default).
[ @frompublisher = ] frompublisher
Specifies whether the procedure is being executed at the Publisher. @frompublisher is bit, with a default of 0
.
A value of 1
means that the procedure is being executed from the Publisher on the publication database.
Return code values
0
(success) or 1
(failure).
Remarks
sp_addqreader_agent
is used in transactional replication.
sp_addqreader_agent
must be executed at least once at a Distributor that supports queued updating after sp_adddistributiondb but before sp_addpublication.
The Queue Reader Agent job is removed when you execute sp_dropdistributiondb.
Permissions
Only members of the sysadmin fixed server role can execute sp_addqreader_agent
.
Related content
Phản hồi
https://aka.ms/ContentUserFeedback.
Sắp ra mắt: Trong năm 2024, chúng tôi sẽ dần gỡ bỏ Sự cố với GitHub dưới dạng cơ chế phản hồi cho nội dung và thay thế bằng hệ thống phản hồi mới. Để biết thêm thông tin, hãy xem:Gửi và xem ý kiến phản hồi dành cho