sp_help_jobstep (Transact-SQL)

Si applica a: SQL Server

Restituisce informazioni per i passaggi di un processo usato dal servizio SQL Server Agent per eseguire attività automatizzate.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @job_id = ] 'job_id'

ID del processo per il quale si desidera ottenere le informazioni. @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

[ @suffix = ] suffisso

Flag che indica se una descrizione di testo viene aggiunta alla colonna flags nell'output. @suffix è bit, con il valore predefinito 0. Se il suffisso @è 1, viene aggiunta una descrizione.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

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 , questo valore è il codice di uscita del processo di un comando riuscito.
on_success_action tinyint Azione da eseguire se il passaggio viene eseguito correttamente:

1 = Chiudere il processo che segnala l'esito positivo.
2 = Chiudere il processo che segnala l'errore.
3 = Andare al passaggio successivo.
4 = Vai al passaggio.
on_success_step_id int Se on_success_action è 4, questo valore indica il passaggio successivo da eseguire.
on_fail_action tinyint Azione da eseguire se il passaggio non viene eseguito correttamente. I valori sono uguali a on_success_action.
on_fail_step_id int Se on_fail_action è 4, questo valore indica il passaggio successivo da eseguire.
server sysname Riservato.
database_name sysname Per un passaggio Transact-SQL, questo valore è il database in cui viene eseguito il comando.
database_user_name sysname Per un passaggio Transact-SQL, questo valore è il contesto utente del database in cui viene eseguito il comando.
retry_attempts int Numero massimo di tentativi di ripetizione del comando (in caso di esito negativo).
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 passaggi transact-SQL, CmdExec e PowerShell ).
last_run_outcome int Risultato dell'ultima esecuzione del passaggio:

0 = Non riuscito
1 = Riuscito
2 = Riprovare
3 = Annullato
5 = Sconosciuto
last_run_duration int Durata (hhmmss) del passaggio l'ultima volta che è stata eseguita.
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 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 passaggi di processo per i processi di cui sono proprietari.

Esempi

R. 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