sp_helpdynamicsnapshot_job (Transact-SQL)

適用対象: SQL Server Azure SQL Managed Instance

フィルター処理されたデータ スナップショットを生成するエージェント ジョブに関する情報を返します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

sp_helpdynamicsnapshot_job
    [ [ @publication = ] N'publication' ]
    [ , [ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname' ]
    [ , [ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid' ]
[ ; ]

引数

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値は % で、指定した @dynamic_snapshot_jobid とすべてのパブリケーションの @dynamic_snapshot_jobname に一致するすべてのフィルター処理されたデータ スナップショット ジョブに関する情報を返します。

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

フィルター処理されたデータ スナップショット ジョブの名前。 @dynamic_snapshot_jobnamesysname で、既定値は % で、指定した @dynamic_snapshot_jobnameを持つパブリケーションのすべての動的ジョブを返します。 ジョブの作成時にジョブ名が明示的に指定されていない場合、ジョブ名は 'dyn_' + <name of the standard snapshot job> + <GUID>形式になります。

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

フィルター処理されたデータ スナップショット ジョブの識別子。 @dynamic_snapshot_jobiduniqueidentifier で、既定値は NULL で、指定した @dynamic_snapshot_jobnameに一致するすべてのスナップショット ジョブを返します。

結果セット

列名 データ型 説明
id int フィルター処理されたデータ スナップショット ジョブを識別します。
job_name sysname フィルター処理されたデータ スナップショット ジョブの名前。
job_id uniqueidentifier ディストリビューターのSQL Server エージェント ジョブを識別します。
dynamic_filter_login sysname パブリケーションに対して定義されたパラメーター化された行フィルターで SUSER_SNAME 関数を評価するために使用される値。
dynamic_filter_hostname sysname パブリケーションに対して定義されたパラメーター化された行フィルターで HOST_NAME 関数を評価するために使用される値。
dynamic_snapshot_location nvarchar (255) パラメーター化された行フィルターが使用されている場合にスナップショット ファイルが読み取られたフォルダーへのパス。
frequency_type int エージェントの実行をスケジュールする頻度を指定します。これらの値の 1 つを指定できます。

1 = 1 回
2 = オンデマンド
4 = 日単位
8 = 週単位
16 = 月単位
32 = 月単位の相対
64 = 自動開始
128 = 繰り返し
frequency_interval int エージェントの実行日。次のいずれかの値になります。

1 = 日曜日
2 = 月曜日
3 = 火曜日
4 = 水曜日
5 = 木曜日
6 = 金曜日
7 = 土曜日
8 = 日
9 = 平日
10 = 週末
frequency_subday_type int frequency_type4 (日単位) の場合にエージェントを実行する頻度を定義する型で、これらの値のいずれかを指定できます。

1 = 指定した時刻
2 = 秒
4 = 分
8 = 時間
frequency_subday_interval int エージェントのスケジュールされた実行の間に発生する frequency_subday_type の間隔の数。
frequency_relative_interval int frequency_type32 (月単位の相対値) である場合、エージェントが特定の月に実行される週です。これらの値のいずれかを指定できます。

1 = First
2 = Second
4 = 3 番目
8 = 4 番目
16 = Last
frequency_recurrence_factor int エージェントのスケジュールされた実行の間の週または月数。
active_start_date int エージェントの実行が最初にスケジュールされた日付。 yyyyMMdd形式です。
active_end_date int エージェントの実行が最後にスケジュールされた日付( yyyyMMdd形式)。
active_start_time int エージェントが最初に実行されるようにスケジュールされた時刻。 HHmmss形式です。
active_end_time int エージェントの実行が最後にスケジュールされた時刻( HHmmss形式)。

リターン コードの値

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

解説

sp_helpdynamicsnapshot_job はマージ レプリケーションで使用されます。

すべての既定のパラメーター値を使用すると、パブリケーション データベース全体のすべてのパーティション 分割データ スナップショット ジョブに関する情報が返されます。

アクセス許可

sysadmin固定サーバー ロール、db_owner固定データベース ロール、パブリケーションのパブリケーション アクセス リストのメンバーのみが、sp_helpdynamicsnapshot_job実行できます。