sp_help_jobserver (Transact-SQL)
適用対象: 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
関連するコンテンツ
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示