sp_addsubscriber_schedule (Transact-SQL)
为分发代理和合并代理添加计划。 此存储过程在发布服务器上对任何数据库执行。
语法
sp_addsubscriber_schedule [ @subscriber = ] 'subscriber'
[ , [ @agent_type = ] agent_type ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @publisher = ] 'publisher' ]
参数
[ @subscriber= ] 'subscriber'
订阅服务器的名称。subscriber 的数据类型为 sysname。 订阅服务器的名称必须在数据库中唯一,不能已经存在,不能为 NULL。[ @agent_type=] agent_type
代理的类型。agent_type 的数据类型为 smallint,可以是下列值之一。值
说明
0(默认值)
分发代理
1
合并代理
[ @frequency_type=] frequency_type
安排分发代理计划的频率。frequency_type 的数据类型为 int,可以是下列值之一。值
说明
1
执行一次
2
按需
4
每天
8
每周
16
每月
32
“每月”选项相关
64(默认值)
自动启动
128
重复执行
[ @frequency_interval=] frequency_interval
应用于由 frequency_type 所设频率的值。frequency_interval 的数据类型为 int,默认值为 1。[ @frequency_relative_interval = ]frequency_relative_interval
分发代理的日期。 如果 frequency_type 设置为 32(与“每月”选项相关),则使用此参数。frequency_relative_interval 的数据类型为 int,可以是下列值之一。值
说明
1(默认值)
第一个
2
第二个
4
第三个
8
第四个
16
最后一个
[ @frequency_recurrence_factor=] frequency_recurrence_factor
frequency_type 使用的重复因子。frequency_recurrence_factor 的数据类型为 int,默认值为 0。[ @frequency_subday = ]frequency_subday
在指定期内重新安排计划的频率。frequency_subday 的数据类型为 int,可以是下列值之一。值
说明
1
一次
2
第二个
4(默认值)
分钟
8
小时
[ @frequency_subday_interval = ]frequency_subday_interval
frequency_subday 的间隔。frequency_subday_interval 的数据类型为 int,默认值为 5。[ @active_start_time_of_day = ] active_start_time_of_day
第一次安排分发代理的时间,格式为 HHMMSS。active_start_time_of_day 的数据类型为 int,默认值为 0。[ @active_end_time_of_day=] active_end_time_of_day
停止安排分发代理的时间,格式为 HHMMSS。active_end_time_of_day的数据类型为 int,默认值为 235959,表示 24 小时制的晚上 11:59:59。[ @active_start_date = ] active_start_date
第一次安排分发代理的日期,格式为 YYYYMMDD。active_start_date 的数据类型为 int,默认值为 0。[ @active_end_date = ] active_end_date
停止安排分发代理的日期,格式为 YYYYMMDD。active_end_date 的数据类型为 int,默认值为 99991231,表示 9999 年 12 月 31 日。[ @publisher =] 'publisher'
指定一个非 MicrosoftSQL Server 发布服务器。publisher 的数据类型为 sysname,默认值为 NULL。注意 不应为 SQL Server 发布服务器指定 publisher。
返回代码值
0(成功)或 1(失败)
注释
sp_addsubscriber_schedule 用于快照复制、事务复制和合并复制。
权限
只有 sysadmin 固定服务器角色的成员才能执行 sp_addsubscriber_schedule。