sp_help_downloadlist

针对所提供的作业，列出在 sysdownloadlist 系统表中的所有行，或者在未指定作业的情况下列出所有行。

语法

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

是为其返回信息的作业标识号。job_id 的数据类型为 uniqueidentifier，默认值为 NULL。

[@job_name =] 'job_name'

是作业名。job_name 的数据类型为 sysname，默认值为 NULL。

[@operation =] 'operation'

是用于指定作业的有效操作。operation 的数据类型为 varchar(64)，默认值为 NULL，而且可以是下列值之一。

值	描述
DEFECT	请求目标服务器脱离 Master SQLServerAgent 服务的服务器操作。
DELETE	删除整个作业的作业操作。
INSERT	插入整个作业或者刷新现有作业的作业操作。如果可用，则该操作将包含所有的作业步骤与作业调度。
RE-ENLIST	使目标服务器再次将其登记信息（包括轮询间隔和时区）发送到多服务器域的服务器操作。目标服务器还将重新下载 MSXOperator 详细信息。
SET-POLL	为目标服务器轮询多服务器域设置间隔（以秒为单位）的服务器操作。如已指定，则 value 将被解释为所要求的间隔值，其范围从 10 到 28,800。
START	请求开始执行作业的作业操作。
STOP	请求停止执行作业的作业操作。
SYNC-TIME	使目标服务器将其系统时钟与多服务器域时钟同步的服务器操作。因为这是一个费时操作，所以只能有限制地偶尔执行。
UPDATE	仅更新作业的 sysjobs 信息，而不更新作业步骤或作业调度的作业操作。它自动由 sp_update_job 调用。

[@object_type =] 'object_type'

是指定作业的对象类型。object_type 的数据类型为 varchar(64)，默认值为 NULL。object_type 可以是 JOB 也可以是 SERVER。有关 object_type 值的更多信息，请参见 sp_add_category。

[@object_name =] 'object_name'

是对象名。object_name 的数据类型为 sysname，默认值为 NULL。如果 object_type 为 JOB，则 object_name 为作业名称。如果 object_type 为 SERVER，则 object_name 是服务器名称。

[@target_server =] 'target_server'

是目标服务器名称。target_server 的数据类型为 varchar(30)，默认值为 NULL。

[@has_error =] has_error

指明作业是否对错误作出反应。has_error 的数据类型为 tinyint，默认值为 NULL，它表示不对错误作出反应。而 1 表示对所有错误都应作出反应。

[@status =] status

是作业状态。status 的数据类型为 tinyint，默认值为 NULL。

[@date_posted =] date_posted

是日期和时间，在指定的日期和时间上或之后建立的所有项都应该包括在结果集中。date_posted 的数据类型为 datetime，默认值为 NULL。

返回代码值

0（成功）或 1（失败）

结果集

列名	数据类型	描述
instance_id	int	指令的唯一整数标识号。
source_server	nvarchar(30)	发出指令的服务器的计算机名。在 Microsoft® SQL Server™ 7.0 中，这始终是主 (MSX) 服务器的计算机名。
operation_code	nvarchar(4000)	指令的操作代码。
object_name	sysname	受指令影响的对象。
object_id	uniqueidentifier	受指令影响的对象的标识号（用于作业对象的 job_id，或者是用于服务器对象的 0x00），或者特定于 operation_code 的数据值。
target_server	nvarchar(30)	下载此指令的目标服务器。
error_message	nvarchar(1024)	目标服务器在处理此指令的过程中遇到问题时发出的错误信息（如果有）。说明：任何错误信息都将阻止目标服务器进一步下载。
date_posted	datetime	指令发布到表的日期。
date_downloaded	datetime	目标服务器下载指令的日期。
Status	tinyint	作业状态： 0 = 尚未下载 1 = 已成功下载。

权限

执行该过程的权限默认授予 sysadmin 固定服务器角色或 db_owner 固定数据库角色，他们可以将权限授予其他用户。

示例

下面的示例针对 Weekly Sales Data Backup 作业列出 sysdownloadlist 中的行。

USE msdb
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

请参见

系统存储过程