sp_helpqreader_agent (Transact-SQL)
Applies to: SQL Server Azure SQL Managed Instance
Returns properties of the Queue Reader agent. This stored procedure is executed at the Distributor on the distribution database or at the Publisher on any database.
Transact-SQL syntax conventions
Syntax
sp_helpqreader_agent [ [ @frompublisher = ] frompublisher ]
[ ; ]
Arguments
[ @frompublisher = ] frompublisher
Specifies whether the stored procedure is called at the Publisher or at the Distributor. @frompublisher is bit, with a default of 0
.
1
means that the stored procedure is called from the Publisher.0
means that the stored procedure is called from the Distributor.
Result set
Column name | Data type | Description |
---|---|---|
id |
int | ID of the agent. |
name |
nvarchar(100) | Name of the agent. |
job_id |
uniqueidentifier | Unique ID of the agent job. |
job_login |
nvarchar(512) | Is the Windows account under which the Distribution agent runs, which is returned in the format <domain>\<username> . |
job_password |
sysname | For security reasons, a value of ********** is always returned. |
Return code values
0
(success) or 1
(failure).
Remarks
sp_helpqreader_agent
is used in transactional replication.
Permissions
When the value of frompublisher is 1
, only members of the sysadmin fixed server role at the Publisher or members of the db_owner fixed database role on the publication database can execute sp_helpqreader_agent
. Otherwise, only members of the sysadmin fixed server role at the Distributor or members of the db_owner fixed database role on the distribution database can execute sp_helpqreader_agent
.