• 项目

sp_addqreader_agent (Transact-SQL)

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

主题链接图标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。