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