sp_help_downloadlist (Transact-SQL)

  • 项目

适用于：SQL Server

列出提供的作业的 sysdownloadlist 系统表中的所有行，如果未指定作业，则列出所有行。

Transact-SQL 语法约定

语法

  
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。

注意

必须指定 job_id 或 job_name ，但不能同时指定两者。

[ @operation = ] 'operation' 指定作业的有效操作。 operation 为 varchar (64) ，默认值为 NULL，可以是以下值之一。

值 说明
缺陷 请求目标服务器脱离 Master SQLServerAgent 服务的服务器操作。
DELETE 作业操作，删除整个作业。
INSERT 作业操作，插入整个作业或者刷新现有作业。 如果可用，此操作将包含所有作业步骤与作业计划。
重新登记 服务器操作，使目标服务器再次将其登记信息（包括轮询间隔和时区）发送到多服务器域。 目标服务器还会重新下载 MSXOperator 详细信息。
SET-POLL 服务器操作，设置目标服务器轮询多服务器域的间隔（以秒为单位）。 如果指定， 值 将解释为所需的间隔值，可以是 10 到 28，800 的值。
开始 作业操作，请求开始执行作业。
停止 作业操作，请求停止执行作业。
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 (Transact-SQL) 。

[ @object_name = ] 'object_name' 对象的名称。 object_name 为 sysname，默认值为 NULL。 如果 object_type 为 JOB， 则object_name为作业名称。 如果 object_type为 SERVER， 则object_name为服务器名称。

[ @target_server = ] 'target_server' 目标服务器的名称。 target_server 为 nvarchar (128) ，默认值为 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 ，或服务器对象) 或特定于operation_code的数据值的 0x00。
target_server nvarchar(30) 下载此指令的目标服务器。
error_message nvarchar(1024) 目标服务器处理此指令时，遇到问题而发出的错误消息（如果有）。

注意：任何错误消息都会阻止目标服务器进一步下载。
date_posted datetime 指令发布到表的日期。
date_downloaded datetime 目标服务器下载指令的日期。
status tinyint 作业的状态：

0 = 尚未下载

1 = 已成功下载。

权限

默认情况下授予 sysadmin 固定服务器角色的成员执行此过程的权限。

示例

以下示例将列出 sysdownloadlist 作业的 NightlyBackups 中的行。

USE msdb ;  
GO  
  
EXEC dbo.sp_help_downloadlist  
    @job_name = N'NightlyBackups',  
    @operation = N'UPDATE',   
    @object_type = N'JOB',   
    @object_name = N'NightlyBackups',  
    @target_server = N'SEATTLE2',   
    @has_error = 1,   
    @status = NULL,   
    @date_posted = NULL ;  
GO

另请参阅

系统存储过程 (Transact-SQL)