针对所提供的作业,列出在 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 = 尚未下载 |
执行该过程的权限默认授予 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