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'

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

[ @dynamic_snapshot_jobname = ] N'dynamic_snapshot_jobname'

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

[ @dynamic_snapshot_jobid = ] 'dynamic_snapshot_jobid'

フィルター処理されたデータ スナップショット ジョブの識別子。 @dynamic_snapshot_jobid は uniqueidentifier で、既定値は 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_typeが4 (日単位) の場合にエージェントを実行する頻度を定義する型で、これらの値のいずれかを指定できます。 1 = 指定した時刻 2 = 秒 4 = 分 8 = 時間
frequency_subday_interval	int	エージェントのスケジュールされた実行の間に発生する frequency_subday_type の間隔の数。
frequency_relative_interval	int	frequency_typeが32 (月単位の相対値) である場合、エージェントが特定の月に実行される週です。これらの値のいずれかを指定できます。 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実行できます。

関連するコンテンツ

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