sp_help_job (Transact-SQL)

Restituisce informazioni sui processi utilizzati da SQL Server Agent per l'esecuzione di attività automatizzate in SQL Server. 

Convenzioni della sintassi Transact-SQL

Sintassi

sp_help_job { [ @job_id = ] job_id
[ @job_name = ] 'job_name' } 
     [ , [ @job_aspect = ] 'job_aspect' ] 
     [ , [ @job_type = ] 'job_type' ] 
     [ , [ @owner_login_name = ] 'login_name' ] 
     [ , [ @subsystem = ] 'subsystem' ] 
     [ , [ @category_name = ] 'category' ] 
     [ , [ @enabled = ] enabled ] 
     [ , [ @execution_status = ] status ] 
     [ , [ @date_comparator = ] 'date_comparison' ] 
     [ , [ @date_created = ] date_created ] 
     [ , [ @date_last_modified = ] date_modified ] 
     [ , [ @description = ] 'description_pattern' ]

Argomenti

• [ @job_id =] job_id
  Numero di identificazione del processo. 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.

• [ @job_aspect =] 'job_aspect'
  Attributo del processo da visualizzare. job_aspect è di tipo varchar(9) e il valore predefinito è NULL. I valori possibili sono i seguenti.

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

• [ @job_type =] 'job_type'
  Tipo di processo da includere nel report. job_type è di tipo varchar(12) e il valore predefinito è NULL. job_type può essere LOCAL o MULTI-SERVER.

• [ @owner_login_name =] 'login_name'
  Nome dell'account di accesso proprietario del processo. login_name è di tipo sysname e il valore predefinito è NULL.

• [ @subsystem =] 'subsystem'
  Nome del sottosistema. subsystem è di tipo nvarchar(40) e il valore predefinito è NULL.

• [ @category_name =] 'category'
  Nome della categoria. category è di tipo sysname e il valore predefinito è NULL.

• [ @enabled =] enabled
  Valore che indica se visualizzare informazioni per i processi abilitati o per quelli disabilitati. enabled è di tipo tinyint e il valore predefinito è NULL. 1 indica la visualizzazione dei processi attivati, 0 la visualizzazione di quelli disabilitati.

• [ @execution_status =] status
  Stato di esecuzione dei processi. status è di tipo int e il valore predefinito è NULL. I valori possibili sono i seguenti.

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

• [ @date_comparator =] 'date_comparison'
  Operatore di confronto da utilizzare nei confronti tra date_created e date_modified. date_comparison è di tipo char(1) e può essere =, < o >.

• [ @date_created =] date_created
  Data di creazione del processo. date_created è di tipo datetime e il valore predefinito è NULL.

• [ @date_last_modified =] date_modified
  Data dell'ultima modifica del processo. date_modified è di tipo datetime e il valore predefinito è NULL.

• [ @description =] 'description_pattern'
  Descrizione del processo. description_pattern è di tipo nvarchar(512) e il valore predefinito è NULL. description_pattern può includere i caratteri jolly di SQL Server per i criteri di ricerca.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Set di risultati

Se non è specificato alcun argomento, sp_help_job restituisce il set di risultati seguente.

Se viene specificato job_id o job_name, sp_help_job restituisce i set di risultati aggiuntivi riportati di seguito per i passaggi, le pianificazioni e i server di destinazione del processo.

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

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

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

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

Esempi

A.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.Visualizzazione di un elenco di informazioni per i processi che corrispondono a un criterio specifico

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.Visualizzazione di un elenco di tutte le 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

Vedere anche

Riferimento

sp_add_job (Transact-SQL)

sp_delete_job (Transact-SQL)

sp_update_job (Transact-SQL)

Stored procedure di sistema (Transact-SQL)