sp_help_downloadlist (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，它可以是下列值之一。

  值	描述
  DEFECT	要求目標伺服器從主要 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 (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) 固定伺服器角色的成員。

範例

下列範例會列出 NightlyBackups 作業之 sysdownloadlist 中的資料列。

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

請參閱

參考