sp_help_jobserver (Transact-SQL)
傳回給定作業之伺服器的相關資訊。
.gif "主題連結圖示")
語法
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)