共用方式為

  • 發行項

sp_help_downloadlist (Transact-SQL)

列出提供的作業在 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，它可以是下列值之一。

    值

    描述

    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