• 相关软件
    >sp_help_downloadlist 创建者:webmaster 更新时间:2006-02-16 15:51

    针对所提供的作业,列出在 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_idint指令的唯一整数标识号。
    source_servernvarchar(30)发出指令的服务器的计算机名。在 Microsoft® SQL Server™ 7.0 中,这始终是主 (MSX) 服务器的计算机名。
    operation_codenvarchar(4000)指令的操作代码。
    object_namesysname受指令影响的对象。
    object_iduniqueidentifier受指令影响的对象的标识号(用于作业对象的 job_id,或者是用于服务器对象的 0x00),或者特定于 operation_code 的数据值。
    target_servernvarchar(30)下载此指令的目标服务器。
    error_messagenvarchar(1024)目标服务器在处理此指令的过程中遇到问题时发出的错误信息(如果有)。说明:任何错误信息都将阻止目标服务器进一步下载。
    date_posteddatetime指令发布到表的日期。
    date_downloadeddatetime目标服务器下载指令的日期。
    Statustinyint作业状态:

    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
    相关文章
    本页查看次数: