Compartir vía

sp_help_jobschedule (Transact-SQL)

  • Artículo

Se aplica a: SQL Server

Devuelve información sobre la programación de trabajos usados por SQL Server Management Studio para realizar actividades automatizadas.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_jobschedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @include_description = ] include_description ]
[ ; ]

Argumentos

[ @job_id = ] 'job_id'

Número de identificación del trabajo. @job_id es uniqueidentifier, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.

[ @job_name = ] N'job_name'

Nombre del trabajo. @job_name es sysname, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.

[ @schedule_name = ] N'schedule_name'

Nombre del elemento de programación del trabajo. @schedule_name es sysname, con un valor predeterminado de NULL.

[ @schedule_id = ] schedule_id

Número de identificación del elemento de programación del trabajo. @schedule_id es int, con un valor predeterminado de NULL.

[ @include_description = ] include_description

Especifica si se va a incluir la descripción de la programación en el conjunto de resultados. @include_description es bit, con un valor predeterminado de 0.

  • Cuando 0es , la descripción de la programación no se incluye en el conjunto de resultados.
  • Cuando 1es , la descripción de la programación se incluye en el conjunto de resultados.

Valores de código de retorno

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

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
schedule_id int Número de identificador de la programación.
schedule_name sysname Nombre de la programación.
enabled int Indica si la programación está habilitada (1) o no (0).
freq_type int Valor que indica cuándo se va a ejecutar el trabajo.

1 = Una vez
4 = Diario
8 = Semanal
16 = Mensual
32 = Mensual, en relación con freq_interval
64= Ejecutar cuando se inicia Agente SQL Server servicio.
freq_interval int Días en los que se ejecuta el trabajo. El valor depende del valor de freq_type. Para obtener más información, consulte sp_add_schedule.
freq_subday_type int Unidades para freq_subday_interval. Para obtener más información, consulte sp_add_schedule.
freq_subday_interval int Número de freq_subday_type períodos que se van a producir entre cada ejecución del trabajo. Para obtener más información, consulte sp_add_schedule.
freq_relative_interval int La aparición del trabajo programado de freq_interval en cada mes. Para obtener más información, consulte sp_add_schedule.
freq_recurrence_factor int Número de meses entre las ejecuciones programadas del trabajo.
active_start_date int Fecha en que se activó la programación.
active_end_date int Fecha final de la programación.
active_start_time int Hora del día en que se inicia la programación.
active_end_time int Hora del día en que termina la programación.
date_created datetime Fecha en que se creó la programación.
schedule_description nvarchar(4000) Descripción en inglés de la programación derivada de los valores de msdb.dbo.sysschedules. Cuando @include_description es 0, esta columna contiene texto que indica que no se solicitó la descripción.
next_run_date int Fecha de la programación siguiente hace que se ejecute el trabajo.
next_run_time int La hora de la programación siguiente hace que se ejecute el trabajo.
schedule_uid uniqueidentifier Identificador de la programación.
job_count int Recuento de trabajos devueltos.

Nota:

sp_help_jobschedule devuelve valores de las dbo.sysjobschedules tablas del sistema y dbo.sysschedules de msdb.sysjobschedules las actualizaciones cada 20 minutos. Esto puede afectar a los valores devueltos por este procedimiento almacenado.

Comentarios

Los parámetros de sp_help_jobschedule solo se pueden usar en determinadas combinaciones. Si se especifica @schedule_id, no se pueden especificar @job_id ni @job_name. De lo contrario, los parámetros @job_id o @job_name se pueden usar con @schedule_name.

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 las propiedades de las programaciones de trabajo que poseen.

Ejemplos

A Devolver la programación del trabajo para un trabajo específico

En el ejemplo siguiente se devuelve información de la programación de un trabajo denominado BackupDatabase.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'BackupDatabase' ;
GO

B. Devolver la programación del trabajo para una programación específica

En el ejemplo siguiente se devuelve información de la programación denominada NightlyJobs y el trabajo denominado RunReports.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs';
GO

C. Devolver la programación del trabajo y la descripción de la programación de una programación específica

En el ejemplo siguiente se devuelve información de la programación denominada NightlyJobs y el trabajo denominado RunReports. El conjunto de resultados devuelto incluye una descripción de la programación.

USE msdb;
GO

EXEC dbo.sp_help_jobschedule
    @job_name = N'RunReports',
    @schedule_name = N'NightlyJobs',
    @include_description = 1;
GO

Contenido relacionado