Share via

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），而且可以是下列其中一個值。

值 Description
DEFECT 要求目標伺服器脫離 Master SQL Server Agent 服務的伺服器作業。
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_type 為 JOB， @object_name 為作業名稱。 如果 @object_type 為 SERVER， @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為 datetime，預設值為 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) 固定伺服器角色的成員。

範例

下列範例會列出 中作業的數據sysdownloadlistNightlyBackups列。

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

相關內容