Share via

  • 發行項

sp_help_jobserver (Transact-SQL)

傳回給定作業之伺服器的相關資訊。

主題連結圖示Transact-SQL 語法慣例

語法

sp_help_jobserver
     { [ @job_id = ] job_id 
     | [ @job_name = ] 'job_name' }
     [ , [ @show_last_run_details = ] show_last_run_details ]

引數

  • [@job_id= ] job_id
    將傳回其資訊的作業識別碼。job_id 是 uniqueidentifier，預設值是 NULL。

  • [@job_name= ] 'job_name'
    將傳回其資訊的作業名稱。job_name 是 sysname，預設值是 NULL。

    [!附註]

    您必須指定 job_id 或 job_name，但不能同時指定這兩者。

  • [@show_last_run_details= ] show_last_run_details
    這是指上次執行的執行資訊是否在結果集內。show_last_run_details 是 tinyint，預設值是 0。0 不包括上次執行的資訊，1 包括上次執行的資訊。

傳回碼值

0 (成功) 或 1 (失敗)

結果集

資料行名稱

資料類型

描述

server_id

int

目標伺服器的識別碼。

server_name

nvarchar(30)

目標伺服器的電腦名稱。

enlist_date

datetime

將目標伺服器編列到主要伺服器的日期。

last_poll_date

datetime

目標伺服器前次輪詢主要伺服器的日期。

如果執行 sp_help_jobserver 時，show_last_run_details 是設為 1，結果集會有下列其他資料行。

資料行名稱

資料類型

描述

last_run_date

int

在這部目標伺服器中上次開始執行作業的日期。

last_run_time

int

在這部伺服器中上次開始執行作業的時間。

last_run_duration

int

前次在這部目標伺服器執行作業的持續時間 (以秒為單位)。

last_outcome_message

nvarchar(1024)

描述作業前次的結果。

last_run_outcome

int

前次在這部伺服器執行作業的結果：

0 = 失敗

1 = 成功

3 = 取消

5 = 未知

權限

依預設，只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

如需有關這些角色權限的詳細資料，請參閱＜SQL Server Agent 固定資料庫角色＞。

SQLAgentUserRole 的成員只能檢視他們自己的作業資訊。

範例

下列範例會傳回 NightlyBackups 作業的相關資訊，其中包括上次執行的資訊。

USE msdb ;
GO

EXEC dbo.sp_help_jobserver
    @job_name = N'NightlyBackups',
    @show_last_run_details = 1 ;
GO