sp_help_jobs_in_schedule (Transact-SQL)
Devuelve información sobre los trabajos a los que está adjunta una programación concreta.
.gif "Icono de vínculo a temas")
Sintaxis
sp_help_jobs_in_schedule
[ @schedule_name = ] 'schedule_name' ,
[ @schedule_id = ] schedule_id
Argumentos
[ @schedule_id = ] schedule_id
Identificador de la programación de la que se va a mostrar información. schedule_id es de tipo int y no tiene ningún valor predeterminado. Puede especificarse schedule_id o schedule_name.[ @schedule_name = ] 'schedule_name'
Nombre de la programación de la que se va a mostrar información. schedule_name es de tipo sysname y no tiene ningún valor predeterminado. Puede especificarse schedule_id o schedule_name.
Valores de código de retorno
0 (correcto) o 1 (error)
Conjuntos de resultados
Devuelve el siguiente conjunto de resultados:
Nombre de columna |
Tipo de datos |
Descripción |
|---|---|---|
job_id |
uniqueidentifier |
Id. único del trabajo. |
originating_server |
nvarchar(30) |
Nombre del servidor del que proviene el trabajo. |
name |
sysname |
Nombre del trabajo. |
enabled |
tinyint |
Indica si el trabajo está habilitado para su ejecución. |
description |
nvarchar(512) |
Descripción del trabajo. |
start_step_id |
int |
Id. del paso del trabajo en el que debe comenzar la ejecución. |
category |
sysname |
Categoría del trabajo |
owner |
sysname |
Propietario del trabajo. |
notify_level_eventlog |
int |
Máscara de bits que indica en qué circunstancias se debe registrar un evento de notificación en el registro de aplicación de Microsoft Windows. Puede ser uno de los valores siguientes: 0 = Nunca 1 = Cuando el trabajo se realiza correctamente 2 = Cuando se produce un error en el trabajo 3 = Cuando el trabajo se completa (independientemente del resultado del trabajo) |
notify_level_email |
int |
Máscara de bits que indica en qué circunstancias se debe enviar una notificación por correo electrónico cuando se completa un trabajo. Los valores posibles son los mismos que para notify_level_eventlog. |
notify_level_netsend |
int |
Máscara de bits que indica en qué circunstancias se debe enviar un mensaje de red cuando se completa un trabajo. Los valores posibles son los mismos que para notify_level_eventlog. |
notify_level_page |
int |
Máscara de bits que indica en qué circunstancias se debe enviar un mensaje a un localizador cuando se completa un trabajo. Los valores posibles son los mismos que para notify_level_eventlog. |
notify_email_operator |
sysname |
Nombre de correo electrónico del operador que recibe la notificación. |
notify_netsend_operator |
sysname |
Nombre del equipo o del usuario que se utiliza al enviar mensajes de red. |
notify_page_operator |
sysname |
Nombre del equipo o del usuario que se utiliza al enviar un mensaje a un localizador. |
delete_level |
int |
Máscara de bits que indica en qué circunstancias se debe eliminar un trabajo cuando se completa. Los valores posibles son los mismos que para notify_level_eventlog. |
date_created |
datetime |
Fecha de creación del trabajo. |
date_modified |
datetime |
Fecha en que se modificó el trabajo por última vez. |
version_number |
int |
Versión del trabajo (se actualiza automáticamente cada vez que el trabajo se modifica). |
last_run_date |
int |
Fecha de inicio de la última ejecución del trabajo. |
last_run_time |
int |
Hora de inicio de la última ejecución del trabajo. |
last_run_outcome |
int |
Resultado de la última ejecución del trabajo: 0 = No realizado 1 = Realizado 3 = Cancelado 5 = Desconocido |
next_run_date |
int |
Fecha de la próxima ejecución programada del trabajo. |
next_run_time |
int |
Hora de la próxima ejecución programada del trabajo. |
next_run_schedule_id |
int |
Número de identificación de la próxima ejecución programada. |
current_execution_status |
int |
Estado de ejecución actual. |
current_execution_step |
sysname |
Paso actual de ejecución del trabajo. |
current_retry_attempt |
int |
Si el trabajo se está ejecutando y el paso se ha intentado más de una vez, es el número actual de reintentos. |
has_step |
int |
Número de pasos que tiene el trabajo. |
has_schedule |
int |
Número de programaciones que tiene el trabajo. |
has_target |
int |
Número de servidores de destino que tiene el trabajo. |
type |
int |
Tipo de trabajo: 1 = Trabajo local. 2 = Trabajo multiservidor. 0 = El trabajo no tiene servidores de destino. |
Notas
Este procedimiento muestra información acerca de los trabajos adjuntos a la programación especificada.
Permisos
De manera predeterminada, este procedimiento almacenado lo pueden ejecutar los miembros de la función fija de servidor sysadmin. Al resto de usuarios se les debe conceder una de las siguientes funciones fijas de base de datos del Agente SQL Server en la base de datos msdb:
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Para obtener detalles sobre los permisos de estas funciones, vea Funciones fijas de base de datos del Agente SQL Server.
Los miembros de SQLAgentUserRole sólo pueden ver el estado de los trabajos que les pertenecen.
Ejemplos
En el ejemplo siguiente se muestran los trabajos adjuntos a la programación NightlyJobs.
USE msdb ;
GO
EXEC sp_help_jobs_in_schedule
@schedule_name = N'NightlyJobs' ;
GO