sp_help_jobsteplog (Transact-SQL)

特定の SQL Server エージェントのジョブステップログに関するメタデータを返します。sp_help_jobsteplog では、実際のログは返されません。

構文

sp_help_jobsteplog { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
     [ , [ @step_id = ] step_id ]
     [ , [ @step_name = ] 'step_name' ]

[ @job_id =] 'job_id'
ジョブステップログ情報を返すジョブの識別番号を指定します。job_id のデータ型は int で、既定値は NULL です。

メモ :
job_id または job_name のいずれかを指定する必要があります。両方を指定することはできません。

[ @step_id =] step_id
ジョブステップの識別番号を指定します。指定しない場合は、ジョブのすべてのステップが対象となります。step_id のデータ型は int で、既定値は NULL です。

[ @step_name =] 'step_name'
ジョブステップの名前を指定します。step_name のデータ型は sysname で、既定値は NULL です。

列名	データ型	説明
job_id	uniqueidentifier	ジョブの一意識別子。
job_name	sysname	ジョブの名前。
step_id	int	ジョブステップの識別子。たとえば、ステップがジョブの最初のステップである場合、step_id は 1 になります。
step_name	sysname	ジョブステップの名前。
step_uid	uniqueidentifier	システムによって生成される、ジョブステップの一意識別子。
date_created	datetime	ステップが作成された日付。
date_modified	datetime	ステップが最後に変更された日付。
log_size	float	ジョブステップログのサイズ (MB 単位)。
log	nvarchar(max)	ジョブステップのログ出力。

sp_help_jobsteplog は msdb データベースにあります。

既定では、このストアドプロシージャを実行できるのは、sysadmin 固定サーバーロールのメンバです。他のユーザーには、msdb データベースの次のいずれかの SQL Server エージェント固定データベースロールが許可されている必要があります。

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

SQLAgentUserRole のメンバは、自分が所有するジョブステップのジョブステップログのメタデータだけを表示できます。

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

A. 特定のジョブ内にあるすべてのステップに関するジョブステップログ情報を返す

次の例では、Weekly Sales Data Backup という名前のジョブに関する、すべてのジョブステップログ情報を返します。

USE msdb ;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup' ;
GO

B. 特定のジョブステップに関するジョブステップログ情報を返す

次の例では、Weekly Sales Data Backup という名前のジョブ内にある最初のジョブステップに関するジョブステップログ情報を返します。

USE msdb ;
GO

EXEC dbo.sp_help_jobsteplog
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO