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	ターゲット サーバーが最後にマスター サーバーをポーリングした日付。

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 固定サーバー ロールのメンバーです。 他のユーザーには、 SQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

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)