Share via

sp_help_jobs_in_schedule (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Devuelve información sobre los trabajos a los que está adjunta una programación concreta.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_jobs_in_schedule
    [ [ @schedule_name = ] N'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 int, con un valor predeterminado de NULL.

Se pueden especificar @schedule_id o @schedule_name .

[ @schedule_name = ] N'schedule_name'

Nombre de la programación de la que se va a mostrar información. @schedule_name es sysname, con un valor predeterminado de NULL.

Se pueden especificar @schedule_id o @schedule_name .

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Devuelve el siguiente conjunto de resultados:

Nombre de la 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 que se pueda ejecutar.
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 estos valores:

0 = Nunca
1 = Cuando un trabajo se realiza correctamente
2 = Cuando se produce un error en el trabajo
3 = Cada vez que se complete el trabajo (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 del trabajo la última vez que ejecutó:

0 = Error
1 = Correcto
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 se ha reintentado el paso, este valor es el intento de reintento actual.
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.

Comentarios

Este procedimiento muestra información acerca de los trabajos adjuntos a la programación especificada.

Permisos

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

A otros usuarios se les debe conceder uno de los siguientes Agente SQL Server roles fijos de base de datos en la msdb base de datos:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.

Los miembros de SQLAgentUserRole solo pueden ver el estado de los trabajos que poseen.

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

Contenido relacionado