共用方式為


sp_help_downloadlist (Transact-SQL)

列出提供的作業在 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_iduniqueidentifier,預設值是 NULL。
  • [ @job_name= ] 'job_name'
    這是作業的名稱。job_namesysname,預設值是 NULL。

    ms186231.note(zh-tw,SQL.90).gif附註:
    您必須指定 job_idjob_name,但不能同時指定這兩者。
  • [ @operation= ] 'operation'
    指定作業的有效動作。operationvarchar(64),預設值是 NULL,它可以是下列值之一。

    描述

    DEFECT

    要求目標伺服器從主要 SQLServerAgent 服務中脫離的伺服器作業。

    DELETE

    移除整項作業的作業動作。

    INSERT

    插入整項作業或重新整理現有作業的作業動作。適當的話,這個動作包括所有作業步驟和排程。

    RE-ENLIST

    使目標伺服器將編列資訊 (包括輪詢間隔和時區) 重新傳送到多伺服器網域的伺服器作業。目標伺服器也會重新下載 MSXOperator 詳細資料。

    SET-POLL

    設定目標伺服器輪詢多伺服器網域的間隔 (以秒為單位) 之伺服器作業。如果指定的話,value 會解譯成必要的間隔值,它可以是 1028,800 的值。

    START

    要求開始執行作業的作業動作。

    STOP

    要求停止執行作業的作業動作。

    SYNC-TIME

    使目標伺服器將它的系統時鐘和多伺服器網域同步化的伺服器作業。由於這項作業成本很高,因此,請盡量不要太常執行這項作業。

    UPDATE

    只更新作業 sysjobs 資訊的作業動作,作業步驟或排程不包括在內。sp_update_job 會自動呼叫這個動作。

  • [ @object_type= ] 'object_type'
    指定作業的物件類型。object_typevarchar(64),預設值是 NULL。object_type 可以是 JOB 或 SERVER。如需有關有效 object_type 值的詳細資訊,請參閱<sp_add_category (Transact-SQL)>。
  • [ @object_name= ] 'object_name'
    物件的名稱。object_namesysname,預設值是 NULL。如果 object_type 是 JOB,object_name 就是作業名稱。如果 object_type 是 SERVER,object_name 就是伺服器名稱。
  • [ @target_server= ] 'target_server'
    目標伺服器的名稱。target_servernvarchar(128),預設值是 NULL。
  • [ @has_error= ] has_error
    這是指作業是否應該認可錯誤。has_errortinyint,預設值是 NULL,表示不應該認可任何錯誤。1 表示應該認可所有錯誤。
  • [ @status= ] status
    作業的狀態。statustinyint,預設值是 NULL。
  • [ @date_posted= ] date_posted
    在指定的日期和時間,或之後,建立所有項目的日期和時間都應該包括在結果集中。date_posteddatetime,預設值是 NULL。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱

資料類型

描述

instance_id

int

指示的唯一整數識別碼。

source_server

nvarchar(30)

指示的來源伺服器電腦名稱。在 Microsoft SQL Server 7.0 中,這一律是主要伺服器的電腦名稱。

operation_code

nvarchar(4000)

指示的作業碼。

object_name

sysname

指示所影響的物件。

object_id

uniqueidentifier

指示所影響之物件的識別碼 (作業物件是 job_id,伺服器物件是 0x00),或 operation_code 專用的資料值。

target_server

nvarchar(30)

將下載這個指示的目標伺服器。

error_message

nvarchar(1024)

當目標伺服器在處理這個指示發生問題時,所發出的錯誤訊息 (如果有的話)。

ms186231.note(zh-tw,SQL.90).gif附註:

任何錯誤訊息都會封鎖目標伺服器所有進一步的下載動作。

date_posted

datetime

將指示公佈到資料表中的日期。

date_downloaded

datetime

目標伺服器下載指示的日期。

status

tinyint

作業的狀態:

0 = 尚未下載

1 = 下載成功。

權限

這個程序的執行權限預設會授與系統管理員 (sysadmin) 固定伺服器角色的成員。

範例

A. 列出作業的資訊

下列範例會列出 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

請參閱

參考

系統預存程序 (Transact-SQL)

說明及資訊

取得 SQL Server 2005 協助