sp_help_jobserver （Transact-SQL）

適用於：SQL Server

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

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  

另請參閱

sp_add_jobserver (Transact-SQL)
sp_delete_jobserver （Transact-SQL）
系統預存程序 (Transact-SQL)