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

值	Description
缺陷	要求目標伺服器脫離 Master SQLServerAgent 服務的伺服器作業。
DELETE	移除整個作業的作業作業。
INSERT	插入整個作業或重新整理現有作業的作業作業。 如果適用，此作業會包含所有作業步驟和排程。
RE-ENLIST	導致目標伺服器重新傳送其登記資訊的伺服器作業，包括輪詢間隔和時區至多伺服器網域。 目標伺服器也會重新下載 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 ，或伺服器物件的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  

另請參閱

系統預存程序 (Transact-SQL)