sp_helpdynamicsnapshot_job (Transact-SQL)

傳回產生已篩選資料快照集之代理程式作業的資訊。這個預存程序執行於發行集資料庫的發行者端。

Transact-SQL 語法慣例

語法

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

引數

• [@publication = ] 'publication'
  這是發行集的名稱。publication 是 sysname，預設值是 %，它會傳回符合所有發行集指定 dynamic_snapshot_jobid 和 dynamic_snapshot_jobname 之已篩選資料快照集作業的資訊。

• [@dynamic_snapshot_jobname = ] 'dynamic_snapshot_jobname'
  這是已篩選資料快照集作業的名稱。dynamic_snapshot_jobname 是 sysname，預設值是 %'，它會傳回具有指定 dynamic_snapshot_jobid 之發行集的所有動態作業。如果在建立作業時，沒有明確指定作業名稱，則作業名稱格式如下：

  '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	識別散發者的 MicrosoftSQL Server Agent 作業。
dynamic_filter_login	sysname	這個值用來評估參數化資料列篩選器中針對發行集而定義的 SUSER_SNAME 函數。
dynamic_filter_hostname	sysname	這個值用來評估參數化資料列篩選器中針對發行集而定義的 HOST_NAME 函數。
dynamic_snapshot_location	nvarchar(255)	如果使用參數化資料列篩選器的話，便是要讀取之快照集檔案的資料夾路徑。
frequency_type	int	這是排程執行代理程式的頻率，它可以是下列值之一。 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 = 第一個 2 = 第二個 4 = 第三個 8 = 第四個 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_helpdynamicsnapshot_job 用於合併式複寫中。

如果所有的預設參數值都要使用，則會傳回整個發行集資料庫所有分割資料快照集作業的資訊。

權限

只有系統管理員 (sysadmin) 固定伺服器角色、db_owner 固定資料庫角色以及發行集之發行集存取清單的成員，才能夠執行 sp_helpdynamicsnapshot_job。

請參閱

參考

系統預存程序 (Transact-SQL)