sp_help_jobsteplog (Transact-SQL)

Gäller för:SQL Server

Returnerar metadata om en specifik SQL Server Agent-jobbstegslogg. sp_help_jobsteplog returnerar inte den faktiska loggen.

Transact-SQL syntaxkonventioner

Syntax

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

Arguments

[ @job_id = ] 'job_id'

Jobbidentifieringsnumret för att returnera uppgiftsstegslogginformation. @job_id är unik identifierare, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras, men båda kan inte specificeras.

[ @job_name = ] N'job_name'

Namnet på tjänsten. @job_name är sysname, med standardvärdet .NULL

Antingen @job_id eller @job_name måste specificeras, men båda kan inte specificeras.

[ @step_id = ] step_id

Identifieringsnumret för steget i jobbet. Om det inte inkluderas ingår alla steg i jobbet. @step_id är int, med standardvärdet .NULL

[ @step_name = ] N'step_name'

Namnet på steget i jobbet. @step_name är sysname, med standardvärdet .NULL

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Kolumnnamn Datatyp Description
job_id uniqueidentifier Unik identifierare för jobbet.
job_name sysname Tjänstens namn.
step_id int Identifierare för steget inom jobbet. Till exempel, om steget är det första steget i jobbet, är 1det step_id .
step_name sysname Namnet på steget i jobbet.
step_uid uniqueidentifier Unik identifierare för steget (systemet genererat) i jobbet.
date_created datetime Datum då steget skapades.
date_modified datetime Datum då steget senast ändrades.
log_size float Storleken på loggen för jobbsteget, i megabyte (MB).
log nvarchar(max) Jobbstegsloggens utdata.

Anmärkningar

sp_help_jobsteplog finns i databasen msdb .

Permissions

Du kan ge EXECUTE behörigheter för denna procedur, men dessa behörigheter kan åsidosättas vid en SQL Server-uppgradering.

Andra användare måste tilldelas en av följande SQL Server Agent-fasta databasroller i databasen msdb :

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

För detaljer om behörigheterna för dessa roller, se SQL Server Agent Fixed Database Roles.

Medlemmar i SQLAgentUserRole kan endast se metadata i jobbstegsloggen för jobbsteg som de äger.

Examples

A. Returnerar logginformation om jobbstegslogg för alla steg i ett specifikt jobb

Följande exempel returnerar all uppgiftsstegslogginformation, för jobbet som heter Weekly Sales Data Backup.

USE msdb;
GO

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

B. Returnera logginformation om jobbsteget om ett specifikt jobbsteg

Följande exempel returnerar logginformation om jobbsteget om det första jobbsteget för jobbet som heter Weekly Sales Data Backup.

USE msdb;
GO

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