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'
指定非 Microsoft SQL Server 發行者。publisher 是 sysname,預設值是 NULL。附註: SQL Server 發行者不應指定 publisher。
傳回碼值
0 (成功) 或 1 (失敗)
備註
sp_addsubscriber_schedule 用於快照式複寫、交易式複寫和合併式複寫中。
權限
只有系統管理員 (sysadmin) 固定伺服器角色的成員,才能夠執行 sp_addsubscriber_schedule。
請參閱
參考
sp_changesubscriber_schedule (Transact-SQL)
系統預存程序 (Transact-SQL)