次の方法で共有


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_name= ] 'job_name'
    情報を返すジョブの名前を指定します。job_name のデータ型は sysname で、既定値は NULL です。

    ms179858.note(ja-jp,SQL.90).gifメモ :
    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_details1 を指定して 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 エージェント固定データベース ロールが許可されている必要があります。

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

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

戻り値

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

次の例では、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)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手