sp_addqreader_agent (Transact-SQL)

适用于: SQL Server Azure SQL 托管实例

为给定分发服务器添加队列读取器代理。 此存储过程在分发服务器上针对分发数据库执行,或在发布服务器上针对发布数据库执行。

Transact-SQL 语法约定

语法

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

参数

[ @job_login = ] N'job_login'

运行代理的 Windows 帐户的登录名。 @job_loginnvarchar(257),默认值为 NULL. 此 Windows 帐户总是用于与分发服务器建立代理连接。

[ @job_password = ] N'job_password'

运行代理的 Windows 帐户的密码。 @job_password为 sysname,无默认值。

重要

不要将身份验证信息存储在脚本文件中。 为保证安全性,应当在运行时再提供登录名和密码。

[ @job_name = ] N'job_name'

现有代理作业的名称。 @job_name为 sysname,默认值为 NULL. 只有在使用现有作业而不是新创建作业(默认值)创建代理时,才需要指定此参数。

[ @frompublisher = ] frompublisher

指定是否在发布服务器上执行该过程。 @frompublisher为,默认值为 0.

一个值 1 ,表示过程正在从发布服务器上对发布数据库执行。

返回代码值

0(成功)或 1(失败)。

注解

sp_addqreader_agent 用于事务复制。

sp_addqreader_agent必须在支持在sp_adddistributiondb之后但在sp_addpublication之前排队更新的分发服务器上至少执行一次。

执行 sp_dropdistributiondb时,将删除队列读取器代理作业。

权限

只有 sysadmin 固定服务器角色的成员才能执行sp_addqreader_agent