sp_addsubscriber_schedule (Transact-SQL)
新增散發代理程式和合併代理程式的排程。 這個預存程序執行於任何資料庫的發行者端。
.gif "主題連結圖示")
語法
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'
指定非 Microsoft SQL Server 發行者。 publisher 是 sysname，預設值是 NULL。注意
SQL Server 發行者不應指定 publisher。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_addsubscriber_schedule 用於快照式複寫、異動複寫和合併式複寫中。
權限
只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行 sp_addsubscriber_schedule。