sp_helpdynamicsnapshot_job (Transact-SQL)
適用対象: 
SQL Server Azure SQL Managed Instance
フィルター処理されたデータ スナップショットを生成するエージェント ジョブに関する情報を返します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。
構文
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 = First2 = Second4 = 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実行できます。