針對所提供的作業(yè),列出在 sysdownloadlist 系統(tǒng)表中的所有行,或者在未指定作業(yè)的情況下列出所有行。
sp_help_downloadlist [ [ @job_id = ] job_id | [ @job_name = ] 'job_name' ]
[ , [ @operation = ] 'operation' ]
[ , [ @object_type = ] 'object_type' ]
[ , [ @object_name = ] 'object_name' ]
[ , [ @target_server = ] 'target_server' ]
[ , [ @has_error = ] has_error ]
[ , [ @status =] status ]
[ , [ @date_posted = ] date_posted ]
[@job_id =] job_id
是為其返回信息的作業(yè)標(biāo)識號。job_id 的數(shù)據(jù)類型為 uniqueidentifier,默認值為 NULL。
[@job_name =] 'job_name'
是作業(yè)名。job_name 的數(shù)據(jù)類型為 sysname,默認值為 NULL。
[@operation =] 'operation'
是用于指定作業(yè)的有效操作。operation 的數(shù)據(jù)類型為 varchar(64),默認值為 NULL,而且可以是下列值之一。
值 | 描述 |
---|---|
DEFECT | 請求目標(biāo)服務(wù)器脫離 Master SQLServerAgent 服務(wù)的服務(wù)器操作。 |
DELETE | 刪除整個作業(yè)的作業(yè)操作。 |
INSERT | 插入整個作業(yè)或者刷新現(xiàn)有作業(yè)的作業(yè)操作。如果可用,則該操作將包含所有的作業(yè)步驟與作業(yè)調(diào)度。 |
RE-ENLIST | 使目標(biāo)服務(wù)器再次將其登記信息(包括輪詢間隔和時區(qū))發(fā)送到多服務(wù)器域的服務(wù)器操作。目標(biāo)服務(wù)器還將重新下載 MSXOperator 詳細信息。 |
SET-POLL | 為目標(biāo)服務(wù)器輪詢多服務(wù)器域設(shè)置間隔(以秒為單位)的服務(wù)器操作。如已指定,則 value 將被解釋為所要求的間隔值,其范圍從 10 到 28,800。 |
START | 請求開始執(zhí)行作業(yè)的作業(yè)操作。 |
STOP | 請求停止執(zhí)行作業(yè)的作業(yè)操作。 |
SYNC-TIME | 使目標(biāo)服務(wù)器將其系統(tǒng)時鐘與多服務(wù)器域時鐘同步的服務(wù)器操作。因為這是一個費時操作,所以只能有限制地偶爾執(zhí)行。 |
UPDATE | 僅更新作業(yè)的 sysjobs 信息,而不更新作業(yè)步驟或作業(yè)調(diào)度的作業(yè)操作。它自動由 sp_update_job 調(diào)用。 |
[@object_type =] 'object_type'
是指定作業(yè)的對象類型。object_type 的數(shù)據(jù)類型為 varchar(64),默認值為 NULL。object_type 可以是 JOB 也可以是 SERVER。有關(guān) object_type 值的更多信息,請參見 sp_add_category。
[@object_name =] 'object_name'
是對象名。object_name 的數(shù)據(jù)類型為 sysname,默認值為 NULL。如果 object_type 為 JOB,則 object_name 為作業(yè)名稱。如果 object_type 為 SERVER,則 object_name 是服務(wù)器名稱。
[@target_server =] 'target_server'
是目標(biāo)服務(wù)器名稱。target_server 的數(shù)據(jù)類型為 varchar(30),默認值為 NULL。
[@has_error =] has_error
指明作業(yè)是否對錯誤作出反應(yīng)。has_error 的數(shù)據(jù)類型為 tinyint,默認值為 NULL,它表示不對錯誤作出反應(yīng)。而 1 表示對所有錯誤都應(yīng)作出反應(yīng)。
[@status =] status
是作業(yè)狀態(tài)。status 的數(shù)據(jù)類型為 tinyint,默認值為 NULL。
[@date_posted =] date_posted
是日期和時間,在指定的日期和時間上或之后建立的所有項都應(yīng)該包括在結(jié)果集中。date_posted 的數(shù)據(jù)類型為 datetime,默認值為 NULL。
0(成功)或 1(失敗)
列名 | 數(shù)據(jù)類型 | 描述 |
---|---|---|
instance_id | int | 指令的唯一整數(shù)標(biāo)識號。 |
source_server | nvarchar(30) | 發(fā)出指令的服務(wù)器的計算機名。在 Microsoft® SQL Server™ 7.0 中,這始終是主 (MSX) 服務(wù)器的計算機名。 |
operation_code | nvarchar(4000) | 指令的操作代碼。 |
object_name | sysname | 受指令影響的對象。 |
object_id | uniqueidentifier | 受指令影響的對象的標(biāo)識號(用于作業(yè)對象的 job_id,或者是用于服務(wù)器對象的 0x00),或者特定于 operation_code 的數(shù)據(jù)值。 |
target_server | nvarchar(30) | 下載此指令的目標(biāo)服務(wù)器。 |
error_message | nvarchar(1024) | 目標(biāo)服務(wù)器在處理此指令的過程中遇到問題時發(fā)出的錯誤信息(如果有)。說明:任何錯誤信息都將阻止目標(biāo)服務(wù)器進一步下載。 |
date_posted | datetime | 指令發(fā)布到表的日期。 |
date_downloaded | datetime | 目標(biāo)服務(wù)器下載指令的日期。 |
Status | tinyint | 作業(yè)狀態(tài): 0 = 尚未下載 |
執(zhí)行該過程的權(quán)限默認授予 sysadmin 固定服務(wù)器角色或 db_owner 固定數(shù)據(jù)庫角色,他們可以將權(quán)限授予其他用戶。
下面的示例針對 Weekly Sales Data Backup 作業(yè)列出 sysdownloadlist 中的行。
USE msdb相關(guān)文章
EXEC sp_help_downloadlist @job_name='Weekly Sales Data Backup', @operation='UPDATE',
@object_type='JOB',
@object_name='Weekly Sales Backup',
@target_server='SEATTLE2',
@has_error=1,
@status=NULL,
@date_posted=NULL