次の方法で共有

sp_help_jobsteplog (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

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

Transact-SQL 構文表記規則

構文

sp_help_jobsteplog
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
[ ; ]

引数

[ @job_id = ] 'job_id'

ジョブ ステップ ログ情報を返すジョブ ID 番号。 @job_idは uniqueidentifier で、既定値は NULL.

@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。

[ @job_name = ] N'job_name'

ジョブの名前。 @job_nameは sysname で、既定値は NULL.

@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。

[ @step_id = ] step_id

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

[ @step_name = ] N'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 。

アクセス許可

このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、データベース内の固定データベース ロール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

関連するコンテンツ