sp_helpdynamicsnapshot_job (Transact-SQL)
傳回產生已篩選資料快照集之代理程式作業的資訊。這個預存程序執行於發行集資料庫的發行者端。
.gif "主題連結圖示")
語法
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 的快照集作業。
傳回碼值
0 (成功) 或 1 (失敗)
結果集
| 資料行名稱 | 資料類型 | 描述 |
|---|---|---|
id |
int |
識別已篩選資料快照集作業。 |
job_name |
sysname |
已篩選資料快照集作業的名稱。 |
job_id |
uniqueidentifier |
識別散發者的 Microsoft SQL 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。 |
備註
sp_helpdynamicsnapshot_job 用於合併式複寫中。
如果所有的預設參數值都要使用，則會傳回整個發行集資料庫所有分割資料快照集作業的資訊。
權限
只有系統管理員 (sysadmin) 固定伺服器角色、db_owner 固定資料庫角色以及發行集之發行集存取清單的成員，才能夠執行 sp_helpdynamicsnapshot_job。