sp_help_job (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 possibili valori 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. I possibili valori dijob_type possono 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 attivati o per quelli disattivati. enabled è di tipo tinyint e il valore predefinito è NULL. 1 indica la visualizzazione dei processi attivati, 0 la visualizzazione di quelli disattivati.

• [ @execution_status =] status
  Stato di esecuzione dei processi. status è di tipo int e il valore predefinito è NULL. I possibili valori 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 i possibili valori sono =, < 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

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

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

USE msdb ;
GO

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

Vedere anche

Riferimento