sp_addqreader_agent (Transact-SQL)
适用于: SQL Server Azure 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_login 为 nvarchar(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
。