sp_help_jobserver (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_id または job_name のいずれかを指定する必要があります。両方を指定することはできません。

[ @show_last_run_details= ] show_last_run_details
前回の実行情報を結果セットに含めるかどうかを指定します。show_last_run_details のデータ型は tinyint で、既定値は 0 です。0 を指定した場合、前回の実行情報は含まれず、1 を指定した場合は、情報が含まれます。

列名	データ型	説明
server_id	int	対象サーバーの識別番号
server_name	nvarchar(30)	対象サーバーのコンピュータ名
enlist_date	datetime	対象サーバーがマスタサーバーに参加した日付
last_poll_date	datetime	対象サーバーが最後にマスタサーバーを呼び出した日付

show_last_run_details に 1 を指定して sp_help_jobserver を実行した場合、結果セットにはさらに次の列が含まれます。

列名	データ型	説明
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 エージェント固定データベースロールが許可されている必要があります。

これらのロールの権限の詳細については、「SQL Server エージェントの固定データベースロール」を参照してください。

SQLAgentUserRole のメンバは、自分が所有しているジョブの情報だけを表示できます。

0 (成功) または 1 (失敗)

次の例では、NightlyBackups ジョブに関する情報を、前回の実行情報も含めて返します。

USE msdb ;
GO

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