共用方式為

  • 發行項

sp_addsubscriber_schedule (Transact-SQL)

新增散發代理程式和合併代理程式的排程。這個預存程序執行於任何資料庫的發行者端。

主題連結圖示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。