sp_addqreader_agent (Transact-SQL)
为给定分发服务器添加队列读取器代理。此存储过程在分发服务器上针对分发数据库执行,或在发布服务器上针对发布数据库执行。
语法
sp_addqreader_agent [ @job_login = ] 'job_login'
, [ @job_password = ] 'job_password'
[ , [ @job_name = ] 'job_name'
[ , [ @frompublisher = ] frompublisher
参数
- [ @job_login= ] 'job_login'
运行代理的 Microsoft Windows 帐户的登录名。job_login 的数据类型为 nvarchar(257),无默认值。此 Windows 帐户总是用于与分发服务器建立代理连接。
[ @job_password= ] 'job_password'
运行代理所用的 Windows 帐户的密码。job_password 的数据类型为 sysname,无默认值。安全说明: 请不要将身份验证信息存储在脚本文件中。为保证安全性,应当在运行时再提供登录名和密码。
- [ @job_name= ] 'job_name'
现有代理作业的名称。job_name 的数据类型为 sysname,默认值为 NULL。只有在使用现有作业而不是新创建作业(默认值)创建代理时,才需要指定此参数。
- [ @frompublisher= ] frompublisher
指定是否在发布服务器上执行该过程。frompublisher 的数据类型为 bit,默认值为 0。值为 1 表示是在发布服务器上对发布数据库执行该过程。
返回代码值
0(成功)或 1(失败)
备注
sp_addqreader_agent 用于事务性复制。
执行 sp_adddistributiondb 后但执行 sp_addpublication 前,必须至少在支持排队更新的分发服务器上执行一次 sp_addqreader_agent。
执行 sp_dropdistributiondb 时会删除队列读取器代理作业。
权限
只有 sysadmin 固定服务器角色成员才能执行 sp_addqreader_agent。
请参阅
参考
sp_changeqreader_agent (Transact-SQL)
sp_helpqreader_agent (Transact-SQL)
其他资源
How to: Enable Updating Subscriptions for Transactional Publications (Replication Transact-SQL Programming)
How to: Upgrade Replication Scripts (Replication Transact-SQL Programming)
事务复制的可更新订阅