sp_help_jobsteplog (Transact-SQL)

特定の 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'
    ジョブ ステップ ログ情報を返すジョブの識別番号を指定します。job_id のデータ型は int で、既定値は NULL です。

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

    注意

    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_jobsteplogmsdb データベースにあります。

権限

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

  • 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