sp_help_jobserver (Transact-SQL)

適用対象: SQL サーバー

指定されたジョブのサーバーに関する情報を返します。

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

@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 = 不明

アクセス許可

このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。

• 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)