sp_changesubscriber_schedule (Transact-SQL)
適用対象: SQL Server Azure SQL Managed Instance
サブスクライバーのディストリビューション エージェントまたはマージ エージェントのスケジュールを変更します。 このストアド プロシージャは、任意のデータベースのパブリッシャーで実行されます。
構文
sp_changesubscriber_schedule
[ @subscriber = ] N'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 = ] N'publisher' ]
[ ; ]
引数
[ @subscriber = ] N'subscriber'
サブスクライバーの名前。 @subscriber は sysname で、既定値はありません。 サブスクライバーの名前は、データベース内で一意である必要があり、まだ存在していない必要があり、 NULL
することはできません。
[ @agent_type = ] agent_type
エージェントの種類。 @agent_type は smallint で、既定値は 0
です。
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であり、 @frequency_typeの値によって異なります。
@frequency_typeの値 | @frequency_intervalへの影響 |
---|---|
1 (既定) |
@frequency_interval は使用されません。 |
4 |
@frequency_interval日ごと。 |
8 |
@frequency_interval は、次の 1 つ以上 ( と組み合わせたもの|(ビットごとの OR) 論理演算子):1 = 日曜日2 = 月曜日4 = 火曜日8 = 水曜日16 = 木曜日32 = 金曜日64 = 土曜日 |
16 |
月の @frequency_interval 日。 |
32 |
@frequency_interval は、次のいずれかのオプションです。1 = 日曜日2 = 月曜日3 = 火曜日4 = 水曜日5 = 木曜日6 = 金曜日7 = 土曜日8 = 日9 = 平日10 = 週末 |
64 |
@frequency_interval は使用されません。 |
128 |
@frequency_interval は使用されません。 |
[ @frequency_relative_interval = ] frequency_relative_interval
配布タスクの日付。 @frequency_relative_interval は int であり、これらの値のいずれかを指定できます。
値 | 説明 |
---|---|
1 (既定値) |
最初 |
2 |
Second |
4 |
Third |
8 |
4 番目 |
16 |
最後 |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
@frequency_typeによって使用される繰り返し係数。 @frequency_recurrence_factor は int で、既定値は 0
です。
[ @frequency_subday = ] frequency_subday
定義された期間中にスケジュールを変更する頻度を分単位で指定します。 @frequency_subday は int であり、これらの値のいずれかを指定できます。
値 | 説明 |
---|---|
1 |
1 回。 |
2 |
Second |
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
配布タスクが最初にスケジュールされる時刻。 @active_start_time_of_day は int で、既定値は NULL
です。
[ @active_end_time_of_day = ] active_end_time_of_day
配布タスクのスケジュールが停止する時刻。 @active_end_time_of_day は int で、既定値は 235959
で、24 時間制の午後 11 時 59 分 59 分を意味します。
[ @active_start_date = ] active_start_date
配布タスクが最初にスケジュールされた日付で、 yyyyMMdd
として書式設定されます。 @active_start_date は int で、既定値は NULL
です。
[ @active_end_date = ] active_end_date
配布タスクのスケジュールが停止した日付。 yyyyMMdd
形式。 @active_end_date は int で、既定値は 99991231
で、9999 年 12 月 31 日を意味します。
[ @publisher = ] N'publisher'
SQL Server 以外のパブリッシャーを指定します。 @publisher は sysname で、既定値は NULL
です。
SQL Server パブリッシャーでアーティクルのプロパティを変更する場合は、@publisher を使用しないでください。
リターン コードの値
0
(成功) または 1
(失敗)。
解説
sp_changesubscriber_schedule
は、すべての種類のレプリケーションで使用されます。
アクセス許可
sysadmin固定サーバー ロールのメンバーのみがsp_changesubscriber_schedule
を実行できます。