sp_help_jobsteplog (Transact-SQL)

傳回特定 SQL Server Agent 作業步驟記錄的中繼資料。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_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_jobsteplog 在 msdb 資料庫中。

依預設，只有系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。其他使用者必須被授與 msdb 資料庫的下列其中一個 SQL Server Agent 固定資料庫角色。

如需有關這些角色權限的詳細資料，請參閱＜SQL Server Agent 固定資料庫角色＞。

SQLAgentUserRole 的成員只能檢視他們擁有作業步驟的作業步驟記錄中繼資料。

下列範例會傳回名稱為 Weekly Sales Data Backup 之作業的所有作業步驟記錄資訊。

USE msdb ;
GO

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

下列範例會傳回名稱為 Weekly Sales Data Backup 之作業的第一個作業步驟的作業步驟記錄資訊。

USE msdb ;
GO

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