共用方式為

sp_help_jobserver （Transact-SQL）

  • 發行項

適用於：SQL Server

傳回指定作業之伺服器的相關信息。

Transact-SQL 語法慣例

語法

sp_help_jobserver
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @show_last_run_details = ] show_last_run_details ]
[ ; ]

引數

[ @job_id = ] 'job_id'

要傳回資訊的作業標識碼。 @job_id為 uniqueidentifier，預設值為 NULL。

必須指定@job_id或@job_name，但無法指定兩者。

[ @job_name = ] N'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 = 未知

權限

此預存程式是由 db_owner 角色所擁有。 您可以授與 EXECUTE 任何用戶的許可權，但這些許可權可能會在 SQL Server 升級期間覆寫。

其他用戶必須在資料庫中獲得下列其中一個 SQL Server Agent 固定資料庫角色 msdb ：

  • 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

相關內容