sp_help_jobsteplog (Transact-SQL)

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

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

引数

[ @job_id = ] 'job_id' ジョブ ステップ ログ情報を返すジョブ ID 番号。 job_id は int で、既定値は NULL です。

[ @job_name = ] 'job_name' ジョブの名前。 job_name は sysname で、既定の NULL です。

Note

job_idまたはjob_nameを指定する必要がありますが、どちらも指定できません。

[ @step_id = ] step_id ジョブ内のステップの識別番号。 含まれていない場合は、ジョブ内のすべてのステップが含まれます。 step_id は int で、既定値は NULL です。

[ @step_name = ] 'step_name' ジョブ内のステップの名前。 step_name は sysname で、既定値は NULL です。

リターン コードの値

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

結果セット

列名	データ型	説明
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 固定サーバー ロールのメンバーです。 他のユーザーには、 SQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

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

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

例

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  

参照

sp_add_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_help_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_delete_jobsteplog (Transact-SQL)
SQL Server エージェントのストアド プロシージャ (Transact-SQL)