sp_helpdynamicスナップショット_job (Transact-SQL)

適用対象: SQL ServerAzure SQL Managed Instance

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

Transact-SQL 構文表記規則

構文

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

引数

[ @publication = ] 'publication' パブリケーションの名前を指定します。 publication は sysname で、既定値は %、指定したdynamic_スナップショット_jobidおよびすべてのパブリケーションのdynamic_スナップショット_jobnameに一致するすべてのフィルター処理されたデータスナップショットジョブに関する情報を返します。

[ @dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'フィルター処理されたデータスナップショットジョブの名前です。 dynamic_スナップショット_jobnameは sysname で、既定値は %'、指定したdynamic_スナップショット_jobidを持つパブリケーションのすべての動的ジョブを返します。 ジョブの作成時にジョブ名が明示的に指定されなかった場合、ジョブ名は次の形式になります。

'dyn_' + <name of the standard snapshot job> + <GUID>  

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'フィルター処理されたデータ スナップショット ジョブの識別子です。 dynamic_スナップショット_jobidは uniqueidentifier で、既定値は NULL で、指定したdynamic_スナップショット_jobnameに一致するすべてのスナップショット ジョブが返されます。

結果セット

列名 データ型 説明
id int フィルター処理されたデータスナップショットジョブを識別します。
job_name sysname フィルター処理されたデータ スナップショット ジョブの名前。
job_id uniqueidentifier ディストリビューターの Microsoft SQL Server エージェント ジョブを識別します。
dynamic_filter_login sysname パブリケーションに対して定義されたパラメーター化された行フィルターの SU Standard EditionR_SNAME 関数の評価に使用される値。
dynamic_filter_hostname sysname パブリケーションに対して 定義されたパラメーター化された行フィルターでHOST_NAME 関数を評価するために使用される値。
dynamic_スナップショット_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_typeが 4 (日単位) のときにエージェントを実行する頻度を定義する型で、これらの値のいずれかを指定できます。

1 = 指定した時刻

2 = 秒

4 = 分

8 = 時間
frequency_subday_interval int エージェントのスケジュールされた実行の間に発生するfrequency_subday_typeの間隔の数。
frequency_relative_interval int frequency_typeが 32 (毎月の相対値) である特定の月にエージェントが実行される週であり、これらの値のいずれかを指定できます。

1 = First

2 = 秒

4 = 3 番目

8 = 4 番目

16 = 最後
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_helpdynamicスナップショット_jobはマージ レプリケーションで使用されます。

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

アクセス許可

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

参照

システム ストアド プロシージャ (Transact-SQL)