sp_addqreader_agent (Transact-SQL)

  • 项目

适用于：SQL ServerAzure 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'

运行代理的 Microsoft 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用于事务副本 (replica)。

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

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

权限

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

相关内容