sp_help_jobstep (Transact-SQL)
Restituisce informazioni sui passaggi di un processo utilizzato dal servizio SQL Server Agent per l'esecuzione di attività automatizzate.
.gif "Icona di collegamento a un argomento")
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