Transact-SQL 参考

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_typeJOB,则 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

请参见

系统存储过程