sp_help_jobsteplog (Transact-SQL)

Restituisce i metadati relativi al log di un passaggio specifico del processo di SQL Server Agent. sp_help_jobsteplog non restituisce il log effettivo.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @job_id=] 'job_id'
    ID del processo per il quale si desidera ottenere le informazioni sul log del passaggio. job_id è di tipo int e il valore predefinito è NULL.

  • [ @job_name =] 'job_name'
    Nome del processo. job_name è di tipo sysname e il valore predefinito è NULL.

    [!NOTA]

    È necessario specificare l'argomento job_id oppure l'argomento job_name ma non è possibile specificarli entrambi.

  • [ @step_id =] step_id
    Numero di identificazione del passaggio del processo. Se viene omesso, vengono inclusi tutti i passaggi del processo. step_id è di tipo int e il valore predefinito è NULL.

  • [ @step_name =] 'step_name'
    Nome del passaggio del processo. step_name è di tipo sysname e il valore predefinito è NULL.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nome colonna

Tipo di dati

Descrizione

job_id

uniqueidentifier

ID univoco del processo.

job_name

sysname

Nome del processo.

step_id

int

ID del passaggio all'interno del processo. Ad esempio, se si tratta del primo passaggio nel processo, step_id sarà 1.

step_name

sysname

Nome del passaggio del processo.

step_uid

uniqueidentifier

ID univoco generato dal sistema del passaggio nel processo.

date_created

datetime

Data di creazione del passaggio.

date_modified

datetime

Data dell'ultima modifica del passaggio.

log_size

float

Dimensioni in megabyte (MB) del log dei passaggi del processo.

log

nvarchar(max)

Output del log dei passaggi del processo.

Osservazioni

La stored procedure sp_help_jobsteplog è archiviata nel database msdb.

Autorizzazioni

Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere a uno dei seguenti ruoli predefiniti del database di SQL Server Agent nel database msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Per informazioni sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.

I membri di SQLAgentUserRole possono visualizzare i metadati dei log dei passaggi dei processi solo per i passaggi dei processi di cui sono proprietari.

Esempi

A. Restituzione delle informazioni del log su tutti i passaggi di un processo specifico

Nell'esempio seguente vengono restituite le informazioni del log su tutti i passaggi di un processo denominato Weekly Sales Data Backup.

USE msdb ;
GO

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

B. Restituzione delle informazioni del log su un passaggio specifico

Nell'esempio seguente vengono restituite le informazioni del log relative al primo passaggio del processo denominato Weekly Sales Data Backup.

USE msdb ;
GO

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