Condividi tramite


sp_help_jobstep (Transact-SQL)

Restituisce informazioni sui passaggi di un processo utilizzato dal servizio SQL Server Agent per l'esecuzione di attività automatizzate.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

  • [ @job_id =] 'job_id'
    ID del processo per il quale si desidera ottenere le informazioni. job_id è di tipo uniqueidentifier 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.

  • [ @suffix =] suffix
    Flag che indica se aggiungere una descrizione in formato testo alla colonna flags dell'output. suffixè di tipo bit e il valore predefinito è 0. Se suffix è 1, viene aggiunta una descrizione.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Nome colonna

Tipo di dati

Descrizione

step_id

int

Identificatore univoco del passaggio.

step_name

sysname

Nome del passaggio del processo.

subsystem

nvarchar(40)

Sottosistema in cui eseguire il comando del passaggio.

command

nvarchar(max)

Comando eseguito nel passaggio.

flags

int

Maschera di bit dei valori che controllano il funzionamento del passaggio.

cmdexec_success_code

int

Per un passaggio CmdExec, codice di uscita del processo di un comando eseguito correttamente.

on_success_action

tinyint

Azione da eseguire se il passaggio viene eseguito correttamente:

1 = Uscita in caso di esito positivo.

2 = Uscita in caso di esito negativo.

3 = Esecuzione del passaggio successivo.

4 = Esecuzione di un passaggio.

on_success_step_id

int

Se on_success_action è 4, indica il passaggio da eseguire.

on_fail_action

tinyint

Azione da eseguire se il passaggio non viene eseguito correttamente. I possibili valori corrispondono a quelli di on_success_action.

on_fail_step_id

int

Se on_fail_action è 4, indica il passaggio da eseguire.

server

sysname

Riservato.

database_name

sysname

Per un passaggio Transact-SQL, indica il database in cui viene eseguito il comando.

database_user_name

sysname

Per un passaggio Transact-SQL, indica il contesto utente del database in cui viene eseguito il comando.

retry_attempts

int

Numero massimo di tentativi di esecuzione del comando (nel caso in cui non sia stato eseguito correttamente).

retry_interval

int

Intervallo in minuti che intercorre tra un tentativo e il successivo.

os_run_priority

int

Riservato.

output_file_name

nvarchar(200)

File in cui scrivere l'output del comando (solo per i passaggi Transact-SQL, CmdExec e PowerShell).

last_run_outcome

int

Risultato dell'ultima esecuzione del passaggio:

0 = Non completato

1 = Completato

2 = Nuovo tentativo

3 = Annullato

5 = Stato sconosciuto

last_run_duration

int

Durata in secondi dell'ultima esecuzione del passaggio.

last_run_retries

int

Numero di tentativi di esecuzione del comando durante l'ultima esecuzione del passaggio.

last_run_date

int

Data di inizio dell'ultima esecuzione del passaggio.

last_run_time

int

Ora di inizio dell'ultima esecuzione del passaggio.

proxy_id

int

Proxy per il passaggio del processo.

Osservazioni

sp_help_jobstep è 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 solo i passaggi dei processi di cui sono proprietari.

Esempi

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

In questo esempio vengono restituiti tutti i passaggi del processo Weekly Sales Data Backup.

USE msdb ;
GO

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

B. Restituzione di informazioni su un determinato passaggio di un processo

Nell'esempio seguente vengono restituite informazioni sul primo passaggio del processo Weekly Sales Data Backup.

USE msdb ;
GO

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