sp_help_jobsteplog (TRANSACT-SQL)sp_help_jobsteplog (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

特定のメタデータを返しますSQL ServerSQL Serverエージェント ジョブ ステップのログ。Returns metadata about a specific SQL ServerSQL Server Agent job step log. sp_help_jobsteplog実際のログは返されません。sp_help_jobsteplog does not return the actual log.

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

構文Syntax

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

引数Arguments

[ @job_id = ] 'job_id' ジョブ ステップ ログ情報を返す対象のジョブ識別番号。[ @job_id = ] 'job_id' The job identification number for which to return job step log information. job_idint、既定値は NULL です。job_id is int, 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 NULL.

注意

いずれかjob_idまたはjob_name指定する必要がありますが、両方を指定することはできません。Either job_id or job_name must be specified, but both cannot be specified.

[ @step_id = ] step_id ジョブ ステップの識別番号。[ @step_id = ] step_id The identification number of the step in the job. 含まれていない場合、ジョブのすべての手順が含まれます。If not included, all steps in the job are included. step_idint、既定値は NULL です。step_id is int, with a default of NULL.

[ @step_name = ] 'step_name' ジョブのステップの名前。[ @step_name = ] 'step_name' The name of the step in the job. step_namesysname、既定値は NULL です。step_name is sysname, with a default of NULL.

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

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

結果セットResult Sets

列名Column name データ型Data type 説明Description
job_idjob_id uniqueidentifieruniqueidentifier ジョブの一意の識別子。Unique identifier of the job.
job_namejob_name sysnamesysname ジョブの名前。Name of the job.
step_idstep_id intint ジョブ内のステップの識別子。Identifier for the step within the job. たとえば、次のステップ、ジョブの最初の手順は、そのstep_idは 1 です。For example, if the step is the first step in the job, its step_id is 1.
step_namestep_name sysnamesysname ジョブのステップの名前です。Name of the step in the job.
step_uidstep_uid uniqueidentifieruniqueidentifier (システムによって生成される) のステップの一意識別子ジョブにします。Unique identifier of the step (system generated) in the job.
date_createddate_created datetimedatetime ステップが作成された日付。Date that the step was created.
date_modifieddate_modified datetimedatetime ステップが最後に変更された日付。Date that the step was last modified.
log_sizelog_size floatfloat ジョブ ステップ ログのサイズ (MB 単位)。Size of the job step log in megabytes (MB).
loglog nvarchar(max)nvarchar(max) ジョブ ステップのログ出力します。Job step log output.

コメントRemarks

sp_help_jobsteplogでは、 msdbデータベース。sp_help_jobsteplog is in the msdb database.

アクセス許可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 SQLAgentUserRole can only view job step log metadata for job steps that they own.

使用例Examples

A.A. 特定のジョブ内のすべてのステップに関するジョブ ステップ ログ情報を返しますReturns job step log information for all steps in a specific job

次の例では、Weekly Sales Data Backup という名前のジョブに関する、すべてのジョブ ステップ ログ情報を返します。The following example returns all the job step log information for the job named Weekly Sales Data Backup.

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

B.B. 特定のジョブ ステップに関するジョブ ステップ ログ情報を返すReturn job step log information about a specific job step

次の例では、Weekly Sales Data Backup という名前のジョブ内にある最初のジョブ ステップに関するジョブ ステップ ログ情報を返します。The following example returns job step log information about the first job step for the job named Weekly Sales Data Backup.

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

関連項目See Also

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