sp_changedynamicsnapshot_job (Transact-SQL)

パブリケーションへのサブスクリプション用にスナップショットを生成するエージェント ジョブを、パラメータ化された行フィルタを使って変更します。このストアド プロシージャは、パブリッシャ側でパブリケーション データベースについて実行されます。

Transact-SQL 構文表記規則

構文

sp_changedynamicsnapshot_job [ @publication = ] 'publication'
    [ , [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
    [ , [ @frequency_type = ] frequency_type ] 
    [ , [ @frequency_interval = ] frequency_interval ] 
    [ , [ @frequency_subday = ] frequency_subday ] 
    [ , [ @frequency_subday_interval = ] frequency_subday_interval ] 
    [ , [ @frequency_relative_interval = ] frequency_relative_interval ] 
    [ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ] 
    [ , [ @active_start_date = ] active_start_date ] 
    [ , [ @active_end_date = ] active_end_date ] 
    [ , [ @active_start_time_of_day = ] active_start_time_of_day ] 
    [ , [ @active_end_time_of_day = ] active_end_time_of_day ] 
    [ , [ @job_login = ] 'job_login' ] 
    [ , [ @job_password = ] 'job_password' ] 

引数

• [ @publication = ] 'publication'
  パブリケーションの名前を指定します。publication のデータ型は sysname で、既定値はありません。

• [ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
  変更するスナップショット ジョブの名前を指定します。dynamic_snapshot_jobname のデータ型は sysname で、既定値は N'%' です。dynamic_snapshot_jobid を指定する場合は、dynamic_snapshot_jobname に既定値を使用する必要があります。

• [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'
  変更するスナップショット ジョブの ID を指定します。dynamic_snapshot_jobid のデータ型は uniqueidentifier で、既定値は NULL です。dynamic_snapshot_jobname を指定する場合は、dynamic_snapshot_jobid に既定値を使用する必要があります。

• [ @frequency_type = ] frequency_type
  エージェントをスケジュールに組み込む頻度を指定します。frequency_type のデータ型は int で、次のいずれかの値を指定できます。

  値	説明
  1	指定日時
  2	要求時
  4	毎日
  8	毎週
  16	毎月
  32	月単位
  64	自動的に起動
  128	定期的
  NULL (既定値)

• [ @frequency_interval = ] frequency_interval
  エージェントを実行する日を指定します。frequency_interval のデータ型は int で、次のいずれかの値を指定できます。

  値	説明
  1	日曜日
  2	月曜日
  3	火曜日
  4	水曜日
  5	木曜日
  6	金曜日
  7	土曜日
  8	日
  9	平日
  10	週末
  NULL (既定値)

• [ @frequency_subday = ] frequency_subday
  定義した期間内にスケジュールを組み直す頻度を指定します。frequency_subday のデータ型は int で、次のいずれかの値を指定できます。

  値	説明
  1	1 回
  2	秒
  4	分
  8	時間
  NULL (既定値)

• [ @frequency_subday_interval = ] frequency_subday_interval
  frequency_subday の間隔を指定します。frequency_subday_interval のデータ型は int で、既定値は NULL です。

• [ @frequency_relative_interval = ] frequency_relative_interval
  マージ エージェントを実行する日付を指定します。このパラメータは、frequency_type を 32 (月単位) に設定した場合に使用します。frequency_relative_interval のデータ型は int で、次のいずれかの値を指定できます。

  値	説明
  1	第 1
  2	第 2
  4	第 3
  8	第 4
  16	最終
  NULL (既定値)

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  frequency_type で使用される定期実行係数を指定します。frequency_recurrence_factor のデータ型は int で、既定値は NULL です。

• [ @active_start_date = ] active_start_date
  マージ エージェントを最初にスケジュール設定する日付を YYYYMMDD 形式で指定します。active_start_date のデータ型は int で、既定値は NULL です。

• [ @active_end_date = ] active_end_date
  マージ エージェントのスケジュール設定を停止する日付を YYYYMMDD 形式で指定します。active_end_date のデータ型は int で、既定値は NULL です。

• [ @active_start_time_of_day = ] active_start_time_of_day
  マージ エージェントを最初にスケジュール設定する時刻を HHMMSS 形式で指定します。active_start_time_of_day のデータ型は int で、既定値は NULL です。

• [ @active_end_time_of_day = ] active_end_time_of_day
  マージ エージェントのスケジュール設定を停止する時刻を HHMMSS 形式で指定します。active_end_time_of_day のデータ型は int で、既定値は NULL です。

• [ @job_login= ] 'job_login'
  パラメータ化された行フィルタを使用してサブスクリプション用のスナップショットを生成するときに、スナップショット エージェントを実行する Microsoft Windows アカウントを指定します。job_login のデータ型は nvarchar(257) で、既定値は NULL です。

• [ @job_password= ] 'job_password'
  パラメータ化された行フィルタを使ってサブスクリプション用のスナップショットを生成するときに、スナップショット エージェントを実行する Windows アカウントのパスワードを指定します。job_password のデータ型は nvarchar(257) で、既定値は NULL です。

  セキュリティに関する注意
  可能であれば、実行時、ユーザーに対してセキュリティ資格情報の入力を要求します。スクリプト ファイルに資格情報を格納する必要がある場合は、不正アクセスを防ぐために、ファイルを保護します。

戻り値

0 (成功) または 1 (失敗)

説明

sp_changedynamicsnapshot_job は、パラメータ化された行フィルタを使ったパブリケーションに対するマージ レプリケーションで使用します。

エージェントのログインまたはパスワードを変更した後、変更を有効にするには、エージェントを停止して再起動する必要があります。

権限

sp_changedynamicsnapshot_job を実行できるのは、sysadmin 固定サーバー ロールまたは db_owner 固定データベース ロールのメンバだけです。

関連項目

タスク

レプリケーションのセキュリティ設定を表示および変更する方法 (レプリケーション Transact-SQL プログラミング)

概念

パラメータ化されたフィルタを使用したマージ パブリケーションのスナップショット