共用方式為


sp_help_jobsteplog (Transact-SQL)

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

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

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