共用方式為

sp_help_jobsteplog （Transact-SQL）

  • 發行項

適用於：SQL Server

傳回特定 SQL Server Agent 作業步驟記錄的相關元數據。 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'

要傳回作業步驟記錄資訊的作業標識碼。 @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 Agent 固定資料庫角色 msdb ：

  • 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

相關內容