Condividi tramite


sp_help_jobs_in_schedule (Transact-SQL)

Si applica a: SQL Server

Restituisce le informazioni sui processi ai quali è associata una pianificazione specifica.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sp_help_jobs_in_schedule
    [ [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
[ ; ]

Argomenti

[ @schedule_id = ] schedule_id

Identificatore della pianificazione per cui restituire un elenco di informazioni. @schedule_id è int, con il valore predefinito NULL.

È possibile specificare @schedule_id o @schedule_name .

[ @schedule_name = ] N'schedule_name'

Nome della pianificazione per cui restituire un elenco di informazioni. @schedule_name è sysname, con un valore predefinito .NULL

È possibile specificare @schedule_id o @schedule_name .

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Restituisce il set di risultati seguente:

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 condizioni per la registrazione dell'evento di notifica 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 condizioni per l'invio di 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 condizioni per l'invio di un messaggio in 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 condizioni per l'invio di un messaggio su cercapersone 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 condizioni per l'eliminazione di un processo al termine del 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.
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 valore è 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.

Osservazioni:

Questa stored procedure visualizza le informazioni sui processi associati alla pianificazione specificata.

Autorizzazioni

È possibile concedere EXECUTE autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero 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 lo stato dei processi di cui sono proprietari.

Esempi

Nell'esempio seguente vengono visualizzati i processi associati alla pianificazione NightlyJobs.

USE msdb;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs';
GO