sp_help_jobhistory (TRANSACT-SQL)sp_help_jobhistory (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

マルチサーバー管理ドメインに所属するサーバーのジョブに関する情報を提供します。Provides information about the jobs for servers in the multiserver administration domain.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
sp_help_jobhistory [ [ @job_id = ] job_id ]   
     [ , [ @job_name = ] 'job_name' ]   
     [ , [ @step_id = ] step_id ]   
     [ , [ @sql_message_id = ] sql_message_id ]   
     [ , [ @sql_severity = ] sql_severity ]   
     [ , [ @start_run_date = ] start_run_date ]   
     [ , [ @end_run_date = ] end_run_date ]   
     [ , [ @start_run_time = ] start_run_time ]   
     [ , [ @end_run_time = ] end_run_time ]   
     [ , [ @minimum_run_duration = ] minimum_run_duration ]   
     [ , [ @run_status = ] run_status ]   
     [ , [ @minimum_retries = ] minimum_retries ]   
     [ , [ @oldest_first = ] oldest_first ]   
     [ , [ @server = ] 'server' ]   
     [ , [ @mode = ] 'mode' ]  

引数Arguments

[ @job_id = ] job_id ジョブの識別番号。[ @job_id = ] job_id The job identification number. job_iduniqueidentifier、既定値は NULL です。job_id is uniqueidentifier, with a default of NULL.

[ @job_name = ] 'job_name' ジョブの名前。[ @job_name = ] 'job_name' The name of the job. job_namesysname、既定値は NULL です。job_name is sysname, with a default of NULL.

[ @step_id = ] step_id ステップの識別番号。[ @step_id = ] step_id The step identification number. step_idint、既定値は NULL です。step_id is int, with a default of NULL.

[ @sql_message_id = ] sql_message_id ジョブを実行するときに、Microsoft SQL Server によって返されるエラー メッセージの識別番号。[ @sql_message_id = ] sql_message_id The identification number of the error message returned by Microsoft SQL Server when executing the job. sql_message_idint、既定値は NULL です。sql_message_id is int, with a default of NULL.

[ @sql_severity = ] sql_severity ジョブを実行するときに、SQL Server によって返されるエラー メッセージの重大度レベル。[ @sql_severity = ] sql_severity The severity level of the error message returned by SQL Server when executing the job. sql_severityint、既定値は NULL です。sql_severity is int, with a default of NULL.

[ @start_run_date = ] start_run_date ジョブが開始された日付。[ @start_run_date = ] start_run_date The date the job was started. start_run_dateint、既定値は NULL です。start_run_dateis int, with a default of NULL. start_run_date必要があります形式で入力 yyyymmdd 形式で指定、YYYY は 4 桁の年、MM は 2 桁の月、DD は 2 桁の日の名前。start_run_date must be entered in the form YYYYMMDD, where YYYY is a four-character year, MM is a two-character month name, and DD is a two-character day name.

[ @end_run_date = ] end_run_date ジョブが完了した日付。[ @end_run_date = ] end_run_date The date the job was completed. end_run_dateint、既定値は NULL です。end_run_date is int, with a default of NULL. end_run_date必要があります形式で入力 yyyymmdd 形式で指定、YYYY は 4 桁の年、MM は 2 桁の月、DD は 2 桁の日の名前。end_run_datemust be entered in the form YYYYMMDD, where YYYY is a four-digit year, MM is a two-character month name, and DD is a two-character day name.

[ @start_run_time = ] start_run_time ジョブが開始された時刻。[ @start_run_time = ] start_run_time The time the job was started. start_run_timeint、既定値は NULL です。start_run_time is int, with a default of NULL. start_run_time必要があります形式で入力 hhmmss で、HH は、1 日の 2 文字の 1 時間、MM は、1 日の 2 桁の分 SS は、1 日の 2 桁の秒。start_run_timemust be entered in the form HHMMSS, where HH is a two-character hour of the day, MM is a two-character minute of the day, and SS is a two-character second of the day.

[ @end_run_time = ] end_run_time ジョブの実行を完了した時刻。[ @end_run_time = ] end_run_time The time the job completed its execution. end_run_timeint、既定値は NULL です。end_run_time is int, with a default of NULL. end_run_time必要があります形式で入力 hhmmss で、HH は、1 日の 2 文字の 1 時間、MM は、1 日の 2 桁の分 SS は、1 日の 2 桁の秒。end_run_timemust be entered in the form HHMMSS, where HH is a two-character hour of the day, MM is a two-character minute of the day, and SS is a two-character second of the day.

[ @minimum_run_duration = ] minimum_run_duration ジョブの終了までの時間の最小長。[ @minimum_run_duration = ] minimum_run_duration The minimum length of time for the completion of the job. minimum_run_durationint、既定値は NULL です。minimum_run_duration is int, with a default of NULL. minimum_run_duration必要があります形式で入力 hhmmss で、HH は、1 日の 2 文字の 1 時間、MM は、1 日の 2 桁の分 SS は、1 日の 2 桁の秒。minimum_run_durationmust be entered in the form HHMMSS, where HH is a two-character hour of the day, MM is a two-character minute of the day, and SS is a two-character second of the day.

[ @run_status = ] run_status ジョブの実行状態。[ @run_status = ] run_status The execution status of the job. run_statusint、既定値は null の場合、これらの値のいずれかを指定できます。run_status is int, with a default of NULL, and can be one of these values.

[値]Value 説明Description
00 FailedFailed
11 成功しましたSucceeded
22 再試行 (ステップのみ)Retry (step only)
33 CanceledCanceled
44 実行中のメッセージIn-progress message
55 UnknownUnknown

[ @minimum_retries = ] minimum_retries ジョブが実行を再試行する最小回数。[ @minimum_retries = ] minimum_retries The minimum number of times a job should retry running. minimum_retriesint、既定値は NULL です。minimum_retries is int, with a default of NULL.

[ @oldest_first = ] oldest_first 最初に出力された最も古いジョブを表示するかどうかです。[ @oldest_first = ] oldest_first Is whether to present the output with the oldest jobs first. oldest_firstint、既定値は0、最初、最新のジョブを提供します。oldest_first is int, with a default of 0, which presents the newest jobs first. 1最初に、最も古いジョブを表示します。1 presents the oldest jobs first.

[ @server = ] 'server' ジョブが実行されたサーバーの名前。[ @server = ] 'server' The name of the server on which the job was performed. servernvarchar (30) 、既定値は NULL です。server is nvarchar(30), with a default of NULL.

[ @mode = ] 'mode' SQL Server が、結果セット内のすべての列を出力するかどうか (完全) または列の概要。[ @mode = ] 'mode' Is whether SQL Server prints all columns in the result set (FULL) or a summary of the columns. モードvarchar (7) 、既定値は概要します。mode is varchar(7), with a default of SUMMARY.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

実際の列の一覧は、の値によって異なります。モードします。The actual column list depends on the value of mode. 列の最も包括的なセットを次に示します、ときに返されるモードいっぱいです。The most comprehensive set of columns is shown below and is returned when mode is FULL.

列名Column name データ型Data type 説明Description
instance_idinstance_id intint 履歴エントリの識別番号。History entry identification number.
job_idjob_id uniqueidentifieruniqueidentifier ジョブ識別番号。Job identification number.
job_namejob_name sysnamesysname ジョブの名前。Job name.
step_idstep_id intint ステップ識別番号 (なります0ジョブ履歴の)。Step identification number (will be 0 for a job history).
step_namestep_name sysnamesysname ステップ名。ジョブ履歴の場合は NULL です。Step name (will be NULL for a job history).
sql_message_idsql_message_id intint Transact-SQLTransact-SQL ステップの場合、コマンドの実行中に最も新しく発生した Transact-SQLTransact-SQL エラーの番号。For a Transact-SQLTransact-SQL step, the most recent Transact-SQLTransact-SQL error number encountered while running the command.
sql_severitysql_severity intint Transact-SQLTransact-SQL ステップの場合、コマンドの実行中に発生した最も重大な Transact-SQLTransact-SQL エラーの重大度。For a Transact-SQLTransact-SQL step, the highest Transact-SQLTransact-SQL error severity encountered while running the command.
messagemessage nvarchar(1024)nvarchar(1024) ジョブまたはステップの履歴メッセージ。Job or step history message.
run_statusrun_status intint ジョブまたはステップの結果。Outcome of the job or step.
run_daterun_date intint 日付と、ジョブまたはステップが実行を開始します。Date the job or step began executing.
run_timerun_time intint ジョブまたはステップが実行を開始します。Time the job or step began executing.
run_durationrun_duration intint ジョブまたはステップを実行してからの経過時間 (HHMMSS 形式)。Elapsed time in the execution of the job or step in HHMMSS format.
operator_emailedoperator_emailed nvarchar(20)nvarchar(20) このジョブに関する電子メールを送信したオペレーター (ステップ履歴の場合は NULL)。Operator who was e-mailed regarding this job (is NULL for step history).
operator_netsentoperator_netsent nvarchar(20)nvarchar(20) このジョブに関するネットワーク メッセージを送信したオペレーター (ステップ履歴の場合は NULL)。Operator who was sent a network message regarding this job (is NULL for step history).
operator_pagedoperator_paged nvarchar(20)nvarchar(20) このジョブに関するページを送信したオペレーター (ステップ履歴の場合は NULL)。Operator who was paged regarding this job (is NULL for step history).
retries_attemptedretries_attempted intint ステップの再試行回数 (常にジョブ履歴の 0)。Number of times the step was retried (always 0 for a job history).
serverserver nvarchar(30)nvarchar(30) サーバーのステップまたはジョブを実行します。Server the step or job executes on. 常に (ローカル)。Is always (local).

コメントRemarks

sp_help_jobhistory指定のスケジュールされたジョブの履歴レポートを返します。sp_help_jobhistory returns a report with the history of the specified scheduled jobs. どのパラメーターも指定しない場合は、レポートにはすべての定期ジョブの履歴が含まれます。If no parameters are specified, the report contains the history for all scheduled jobs.

アクセス許可Permissions

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。By default, members of the sysadmin fixed server role can execute this stored procedure. 他のユーザーには、 SQL ServerSQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

メンバー、 SQLAgentUserRoleデータベース ロールは、自分が所有しているジョブの履歴のみを表示できます。Members of the SQLAgentUserRole database role can only view the history for jobs that they own.

使用例Examples

A.A. ジョブのジョブ情報をすべて一覧表示Listing all job information for a job

次の例は、すべてのジョブ情報を一覧表示、NightlyBackupsジョブ。The following example lists all job information for the NightlyBackups job.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobhistory   
    @job_name = N'NightlyBackups' ;  
GO  

B.B. 一定の条件に一致するジョブに関する情報を一覧表示するListing information for jobs that match certain conditions

次の例は、すべての列を出力しのすべてのジョブ情報が失敗したジョブとジョブ ステップのエラー メッセージで失敗しました50100(ユーザー定義エラー メッセージ) と重大度20します。The following example prints all columns and all job information for any failed jobs and failed job steps with an error message of 50100 (a user-defined error message) and a severity of 20.

USE msdb  
GO  
  
EXEC dbo.sp_help_jobhistory  
    @sql_message_id = 50100,  
    @sql_severity = 20,  
    @run_status = 0,  
    @mode = N'FULL' ;  
GO  

関連項目See Also

sp_purge_jobhistory (Transact-SQL) sp_purge_jobhistory (Transact-SQL)
システム ストアド プロシージャ (Transact-SQL)System Stored Procedures (Transact-SQL)