sp_help_jobsteplog (Transact-SQL)

  • Articolo

Si applica a: SQL Server

Restituisce i metadati relativi a un log dei passaggi del processo di SQL Server Agent specifico. sp_help_jobsteplog non restituisce il log effettivo.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @job_id = ] 'job_id'

ID del processo per il quale si desidera ottenere le informazioni sul log del passaggio. @job_id è uniqueidentifier, con un valore predefinito .NULL

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @job_name = ] N'job_name'

Il nome del processo. @job_name è sysname, con il valore predefinito NULL.

È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.

[ @step_id = ] step_id

Numero di identificazione del passaggio del processo. Se viene omesso, vengono inclusi tutti i passaggi del processo. @step_id è int, con il valore predefinito NULL.

[ @step_name = ] N'step_name'

Nome del passaggio del processo. @step_name è sysname, con un valore predefinito .NULL

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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 il passaggio è il primo passaggio del processo, il relativo step_id è 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 del log dei passaggi del processo, in megabyte (MB).
log nvarchar(max) Output del log dei passaggi del processo.

Osservazioni:

sp_help_jobsteplog si trova nel msdb database.

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

È necessario concedere ad altri utenti uno dei ruoli predefiniti del database di SQL Server Agent seguenti:msdb

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

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

Esempi

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

Nell'esempio seguente vengono restituite tutte le informazioni del log dei passaggi del processo per il 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 informazioni sul log dei passaggi del processo, sul 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

Contenuto correlato