通过

sp_help_downloadlist (Transact-SQL)

  • 项目

适用范围：SQL Server

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

Transact-SQL 语法约定

语法

sp_help_downloadlist
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @operation = ] 'operation' ]
    [ , [ @object_type = ] 'object_type' ]
    [ , [ @object_name = ] N'object_name' ]
    [ , [ @target_server = ] N'target_server' ]
    [ , [ @has_error = ] has_error ]
    [ , [ @status = ] status ]
    [ , [ @date_posted = ] date_posted ]
[ ; ]

参数

[ @job_id = ] 'job_id'

要为其返回信息的作业的标识号。 @job_id是 uniqueidentifier，默认值为 NULL.

必须指定@job_id或@job_name，但不能指定这两者。

[ @job_name = ] N'job_name'

作业的名称。 @job_name为 sysname，默认值为 NULL.

必须指定@job_id或@job_name，但不能指定这两者。

[ @operation = ] 'operation'

指定作业的有效操作。 @operation是 varchar（64），可以是其中一个值。

值 说明
DEFECT 请求目标服务器从 Master SQL Server 代理 服务中脱离的服务器操作。
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 = ] N'object_name'

对象的名称。 @object_name为 sysname，默认值为 NULL. 如果@object_typeJOB，则@object_name为作业名称。 如果@object_typeSERVER，则@object_name服务器名称。

[ @target_server = ] N'target_server'

目标服务器的名称。 @target_server为 sysname，默认值为 NULL.

[ @has_error = ] has_error

指定作业是否应确认错误。 @has_error为 tinyint，默认值为 NULL/>，表示不应确认错误。 1 指示应确认所有错误。

[ @status = ] status

作业的状态。 @status为 tinyint，默认值为 NULL.

[ @date_posted = ] date_posted

日期和时间，在指定的日期和时间或之后建立的所有项都应包括在结果集中。 @date_posted 为 日期/时间，默认值为 NULL.

返回代码值

0（成功）或 1（失败）。

结果集

列名称 数据类型 描述
instance_id int 指令的唯一整数标识号。
source_server nvarchar(30) 发出指令的服务器的计算机名。
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 固定服务器角色的成员执行此过程的权限。

示例

以下示例将列出 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

相关内容