sp_help_job (Transact-SQL)

Articolo
05/22/2024

Si applica a: SQL Server

Restituisce informazioni sui processi usati da SQL Server Agent per eseguire attività automatizzate in SQL Server.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_help_job
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @job_aspect = ] 'job_aspect' ]
    [ , [ @job_type = ] 'job_type' ]
    [ , [ @owner_login_name = ] N'owner_login_name' ]
    [ , [ @subsystem = ] N'subsystem' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @execution_status = ] execution_status ]
    [ , [ @date_comparator = ] 'date_comparator' ]
    [ , [ @date_created = ] date_created ]
    [ , [ @date_last_modified = ] date_last_modified ]
    [ , [ @description = ] N'description' ]
[ ; ]

Argomenti

[ @job_id = ] 'job_id'

Numero di identificazione del processo. @job_id è uniqueidentifier, con un valore predefinito .NULL

Per visualizzare un processo specifico, è necessario specificare @job_id o @job_name . Omettere sia @job_id che @job_name per restituire informazioni su tutti i processi.

[ @job_name = ] N'job_name'

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

Per visualizzare un processo specifico, è necessario specificare @job_id o @job_name . Omettere sia @job_id che @job_name per restituire informazioni su tutti i processi.

[ @job_aspect = ] 'job_aspect'

Attributo del processo da visualizzare. @job_aspect è varchar(9) e può essere uno di questi valori.

Valore	Descrizione
`ALL`	Informazioni sugli attributi del processo
`JOB`	Informazioni posizione lavorativa
`SCHEDULES`	Informazioni sulla pianificazione
`STEPS`	Informazioni sui passaggi del processo
`TARGETS`	Informazioni sul server di destinazione

[ @job_type = ] 'job_type'

Tipo di processi da includere nel report.@job_type è varchar(12), con il valore predefinito NULL. @job_type può essere LOCAL o MULTI-SERVER.

[ @owner_login_name = ] N'owner_login_name'

Nome dell'account di accesso proprietario del processo. @owner_login_name è sysname, con il valore predefinito NULL.

[ @subsystem = ] N'subsystem'

Nome del sottosistema. @subsystem è nvarchar(40), con il valore predefinito NULL.

[ @category_name = ] N'category_name'

Nome della categoria. @category_name è sysname, con un valore predefinito .NULL

[ @enabled = ] abilitato

Valore che indica se visualizzare informazioni per i processi abilitati o per quelli disabilitati. @enabled è tinyint, con un valore predefinito .NULL

1 indica i processi abilitati.
0 indica i processi disabilitati.

[ @execution_status = ] execution_status

Stato di esecuzione dei processi. @execution_status è int e può essere uno di questi valori.

Valore	Descrizione
`0`	Restituisce solo i processi che non sono inattive o sospesi.
`1`	In esecuzione.
`2`	In attesa di un thread.
`3`	Tra due tentativi.
`4`	Operazione inattiva.
`5`	Sospeso.
`7`	Esecuzione delle azioni finali in corso.

[ @date_comparator = ] 'date_comparator'

Operatore di confronto da usare nei confronti di @date_created e @date_last_modified. @date_comparator è char(1) e può essere =, <o >.

[ @date_created = ] date_created

Data di creazione del processo. @date_created è datetime, con un valore predefinito .NULL

[ @date_last_modified = ] date_last_modified

Data dell'ultima modifica del processo. @date_last_modified è datetime, con il valore predefinito NULL.

[ @description = ] N'description'

Descrizione del processo. @description è nvarchar(512), con il valore predefinito NULL. @description può includere i caratteri jolly per la corrispondenza dei criteri.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Se non vengono specificati argomenti, sp_help_job restituisce questo set di risultati.

Nome colonna	Tipo di dati	Descrizione
`job_id`	uniqueidentifier	ID univoco del processo.
`originating_server`	nvarchar(30)	Nome del server di provenienza del processo.
`name`	sysname	Nome del processo.
`enabled`	tinyint	Indica se il processo è abilitato, in modo che possa essere eseguito.
`description`	nvarchar(512)	Descrizione del processo.
`start_step_id`	int	ID del passaggio del processo da cui deve iniziare l'esecuzione.
`category`	sysname	Categoria del processo.
`owner`	sysname	Proprietario del processo.
`notify_level_eventlog`	int	Maschera di bit che indica le circostanze in cui un evento di notifica deve essere registrato nel registro applicazioni di Microsoft Windows. I possibili valori sono i seguenti: `0` = Mai `1` = Quando un processo ha esito positivo `2` = Quando il processo ha esito negativo `3` = Ogni volta che il processo viene completato (indipendentemente dal risultato del processo)
`notify_level_email`	int	Maschera di bit che indica le circostanze in cui deve essere inviato un messaggio di posta elettronica di notifica al termine di un processo. I valori possibili sono uguali a per `notify_level_eventlog`.
`notify_level_netsend`	int	Maschera di bit che indica le circostanze in cui deve essere inviato un messaggio di rete al termine di un processo. I valori possibili sono uguali a per `notify_level_eventlog`.
`notify_level_page`	int	Maschera di bit che indica le circostanze in cui deve essere inviata una pagina al termine di un processo. I valori possibili sono uguali a per `notify_level_eventlog`.
`notify_email_operator`	sysname	Nome di posta elettronica dell'operatore a cui inviare la notifica.
`notify_netsend_operator`	sysname	Nome di computer o di utente specificato quando si invia un messaggio in rete.
`notify_page_operator`	sysname	Nome di computer o di utente specificato quando si invia un messaggio su cercapersone.
`delete_level`	int	Maschera di bit che indica le circostanze in cui il processo deve essere eliminato al termine di un processo. I valori possibili sono uguali a per `notify_level_eventlog`.
`date_created`	datetime	Data di creazione del processo.
`date_modified`	datetime	Data dell'ultima modifica del processo.
`version_number`	int	Versione del processo aggiornata automaticamente in corrispondenza di ogni modifica del processo.
`last_run_date`	int	Data dell'ultimo avvio dell'esecuzione del processo.
`last_run_time`	int	Ora dell'ultimo avvio dell'esecuzione del processo.
`last_run_outcome`	int	Risultato dell'ultima esecuzione del processo: `0` = Non riuscito `1` = Riuscito `3` = Annullato `5` = Sconosciuto
`next_run_date`	int	Data pianificata per la successiva esecuzione del processo.
`next_run_time`	int	Ora pianificata per la successiva esecuzione del processo.
`next_run_schedule_id`	int	ID della successiva pianificazione di esecuzione.
`current_execution_status`	int	Stato di esecuzione corrente: `1` = Esecuzione `2` = In attesa di thread `3` = Tra tentativi `4` = Inattiva `5` = Sospeso `6` = Obsoleto `7` = PerformingCompletionActions
`current_execution_step`	sysname	Passaggio di esecuzione corrente all'interno del processo.
`current_retry_attempt`	int	Se il processo è in esecuzione e il passaggio è stato ritentato, questo è il tentativo di ripetizione corrente.
`has_step`	int	Numero di passaggi del processo.
`has_schedule`	int	Numero di pianificazioni del processo.
`has_target`	int	Numero di server di destinazione del processo.
`type`	int	Tipo del processo. `1` = Processo locale. `2` = Processo multiserver. `0` = Il processo non dispone di server di destinazione.

Se si specifica @job_id o @job_name , sp_help_job restituisce questi set di risultati aggiuntivi per i passaggi del processo, le pianificazioni dei processi e i server di destinazione del processo.

Il set di risultati per i passaggi del processo è il seguente.

Nome colonna	Tipo di dati	Descrizione
`step_id`	int	Identificatore univoco (all'interno del processo) del passaggio.
`step_name`	sysname	Nome del passaggio.
`subsystem`	nvarchar(40)	Sottosistema in cui eseguire il comando del passaggio.
`command`	nvarchar(3200)	Comando da eseguire.
`flags`	nvarchar(4000)	Maschera di bit dei valori che controllano il funzionamento del passaggio.
`cmdexec_success_code`	int	Per un passaggio CmdExec , si tratta del codice di uscita del processo di un comando riuscito.
`on_success_action`	nvarchar(4000)	Azione da eseguire se il passaggio viene eseguito correttamente: `1` = Uscire con esito positivo. `2` = Uscire con un errore. `3` = Andare al passaggio successivo. `4` = Vai al passaggio.
`on_success_step_id`	int	Se `on_success_action` è `4`, indica il passaggio successivo da eseguire.
`on_fail_action`	nvarchar(4000)	Azione da eseguire se il passaggio non viene eseguito correttamente. I valori sono uguali a per `on_success_action`.
`on_fail_step_id`	int	Se `on_fail_action` è `4`, indica il passaggio successivo da eseguire.
`server`	sysname	Riservato.
`database_name`	sysname	Per un passaggio Transact-SQL, si tratta del database in cui viene eseguito il comando.
`database_user_name`	sysname	Per un passaggio Transact-SQL, si tratta del contesto utente del database in cui viene eseguito il comando.
`retry_attempts`	int	Numero massimo di tentativi di ripetizione del comando (se non riuscito) prima che il passaggio non sia riuscito.
`retry_interval`	int	Intervallo di tempo in minuti che intercorre tra un tentativo e il successivo.
`os_run_priority`	varchar(4000)	Riservato.
`output_file_name`	varchar(200)	File in cui scrivere l'output del comando (solo passaggi Transact-SQL e CmdExec ).
`last_run_outcome`	int	Risultato dell'ultima esecuzione del passaggio: `0` = Non riuscito `1` = Riuscito `3` = Annullato `5` = 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.

Il set di risultati per le pianificazioni del processo è il seguente.

Nome colonna	Tipo di dati	Descrizione
`schedule_id`	int	ID della pianificazione, univoco per tutti i processi.
`schedule_name`	sysname	Nome della pianificazione, univoco soltanto per il processo specificato.
`enabled`	int	Indica se la pianificazione è attiva (`1`) o meno (`0`).
`freq_type`	int	Valore che indica la frequenza di esecuzione del processo: `1` = Una volta `4` = Giornaliero `8` = Settimanale `16` = Mensile `32` = Mensile, relativo all'oggetto `freq_interval` `64` = Eseguire all'avvio del servizio SQL Server Agent.
`freq_interval`	int	Giorni in cui viene eseguito il processo. Il valore dipende dal valore di `freq_type`. Per altre informazioni, vedere sp_add_schedule
`freq_subday_type`	int	Unità per `freq_subday_interval`. Per altre informazioni, vedere sp_add_schedule
`freq_subday_interval`	int	Numero di `freq_subday_type` periodi che devono verificarsi tra ogni esecuzione del processo. Per altre informazioni, vedere sp_add_schedule
`freq_relative_interval`	int	Occorrenza del processo pianificato di `freq_interval` in ogni mese. Per altre informazioni, vedere sp_add_schedule
`freq_recurrence_factor`	int	Numero di mesi tra l'esecuzione pianificata del processo.
`active_start_date`	int	Data di inizio dell'esecuzione del processo.
`active_end_date`	int	Data di fine dell'esecuzione del processo.
`active_start_time`	int	Ora di inizio dell'esecuzione del processo in `active_start_date.`
`active_end_time`	int	Tempo per terminare l'esecuzione del processo in `active_end_date`.
`date_created`	datetime	Data di creazione della pianificazione.
`schedule_description`	nvarchar(4000)	Descrizione in inglese della pianificazione, se richiesta.
`next_run_date`	int	Data in cui la pianificazione successiva determina l'esecuzione del processo.
`next_run_time`	int	Ora in cui la pianificazione successiva determina l'esecuzione del processo.
`schedule_uid`	uniqueidentifier	Identificatore della pianificazione.
`job_count`	int	Restituisce il numero di processi che fanno riferimento a questa pianificazione.

Il set di risultati per i server di destinazione del processo è il seguente.

Nome colonna	Tipo di dati	Descrizione
`server_id`	int	ID del server di destinazione.
`server_name`	nvarchar(30)	Nome di computer del server di destinazione.
`enlist_date`	datetime	Data di integrazione del server di destinazione nel server master.
`last_poll_date`	datetime	Data dell'ultimo polling del server master eseguito dal server di destinazione.
`last_run_date`	int	Data di inizio dell'ultima esecuzione del processo nel server di destinazione.
`last_run_time`	int	Ora di inizio dell'ultima esecuzione del processo nel server di destinazione.
`last_run_duration`	int	Durata dell'ultima esecuzione del processo nel server di destinazione.
`last_run_outcome`	tinyint	Risultato dell'ultima esecuzione del processo nel server specificato: `0` = Non riuscito `1` = Riuscito `3` = Annullato `5` = Sconosciuto
`last_outcome_message`	nvarchar(1024)	Messaggio visualizzato dopo l'ultima esecuzione del processo nel server di destinazione.

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 processi di cui sono proprietari. I membri di sysadmin, SQLAgentReaderRole e SQLAgentOperatorRole possono visualizzare tutti i processi locali e multiserver.

Esempi

R. Visualizzazione di un elenco di informazioni per tutti i processi

Nell'esempio seguente la stored procedure sp_help_job viene eseguita senza parametri in modo da ottenere informazioni su tutti i processi definiti nel database msdb.

USE msdb;
GO

EXEC dbo.sp_help_job;
GO

B. Elencare le informazioni per i processi che corrispondono a criteri specifici

Nell'esempio seguente viene visualizzato un elenco di informazioni per i processi multiserver di cui è proprietario françoisa dove il processo è attivato e in fase di esecuzione.

USE msdb;
GO

EXEC dbo.sp_help_job
   @job_type = N'MULTI-SERVER',
   @owner_login_name = N'françoisa',
   @enabled = 1,
   @execution_status = 1;
GO

C. Elencare tutti gli aspetti delle informazioni per un processo

Nell'esempio seguente viene visualizzato un elenco di tutti gli aspetti correlati alle informazioni per il processo NightlyBackups.

USE msdb;
GO

EXEC dbo.sp_help_job
    @job_name = N'NightlyBackups',
    @job_aspect = N'ALL';
GO

Condividi tramite

sp_help_job (Transact-SQL)

Sintassi

Argomenti

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @job_aspect = ] 'job_aspect'

[ @job_type = ] 'job_type'

[ @owner_login_name = ] N'owner_login_name'

[ @subsystem = ] N'subsystem'

[ @category_name = ] N'category_name'

[ @enabled = ] abilitato

[ @execution_status = ] execution_status

[ @date_comparator = ] 'date_comparator'

[ @date_created = ] date_created

[ @date_last_modified = ] date_last_modified

[ @description = ] N'description'

Valori del codice restituito

Set di risultati

Autorizzazioni

Esempi

R. Visualizzazione di un elenco di informazioni per tutti i processi

B. Elencare le informazioni per i processi che corrispondono a criteri specifici

C. Elencare tutti gli aspetti delle informazioni per un processo

Commenti e suggerimenti

Risorse aggiuntive

Condividi tramite

sp_help_job (Transact-SQL)

Sintassi

Argomenti

[ @job_id = ] 'job_id'

[ @job_name = ] N'job_name'

[ @job_aspect = ] 'job_aspect'

[ @job_type = ] 'job_type'

[ @owner_login_name = ] N'owner_login_name'

[ @subsystem = ] N'subsystem'

[ @category_name = ] N'category_name'

[ @enabled = ] abilitato

[ @execution_status = ] execution_status

[ @date_comparator = ] 'date_comparator'

[ @date_created = ] date_created

[ @date_last_modified = ] date_last_modified

[ @description = ] N'description'

Valori del codice restituito

Set di risultati

Autorizzazioni

Esempi

R. Visualizzazione di un elenco di informazioni per tutti i processi

B. Elencare le informazioni per i processi che corrispondono a criteri specifici

C. Elencare tutti gli aspetti delle informazioni per un processo

Contenuto correlato

Commenti e suggerimenti

Risorse aggiuntive