Compartir a través de


sp_help_jobschedule (Transact-SQL)

Devuelve información acerca de la programación de los trabajos que SQL Server Management Studio utiliza para realizar actividades automatizadas.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
     [ , [ @schedule_name = ] 'schedule_name' ]
     [ , [ @schedule_id = ] schedule_id ]
     [ , [ @include_description = ] include_description ]

Argumentos

  • [ @job_id= ] job_id
    Número de identificación del trabajo. job_ides de tipo uniqueidentifier y su valor predeterminado es NULL.

  • [ @job_name= ] 'job_name'
    Nombre del trabajo. job_namees de tipo sysname y su valor predeterminado es NULL.

    [!NOTA]

    Se debe especificar job_id o job_name, pero no ambos.

  • [ @schedule_name= ] 'schedule_name'
    Nombre del elemento de programación del trabajo. schedule_namees de tipo sysname y su valor predeterminado es NULL.

  • [ @schedule_id= ] schedule_id
    Número de identificación del elemento de programación del trabajo. schedule_ides de tipo int y su valor predeterminado es 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 de tipo bit y su valor predeterminado es 0. Cuando include_description es 0, la descripción de la programación no se incluye en el conjunto de resultados. Cuando include_description es 1, se incluye la descripción de la programación en el conjunto de resultados.

Valores de código de retorno

0 (correcto) o 1 (error)

Conjuntos de resultados

Nombre de 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 deshabilitada (0).

freq_type

int

Valor que indica cuándo se va a ejecutar el trabajo.

1 = Una vez

4 = Diariamente

8 = Semanalmente

16 = Mensualmente

32 = Mensualmente, relativo a freq_interval

64 = Se ejecuta cuando se inicia el servicio SQLServerAgent

freq_interval

int

Días en que se ejecuta el trabajo. El valor depende del valor de freq_type. Para obtener más información, vea sp_add_schedule (Transact-SQL).

freq_subday_type

int

Unidades para freq_subday_interval. Para obtener más información, vea sp_add_schedule (Transact-SQL).

freq_subday_interval

int

Número de períodos de freq_subday_type que deben transcurrir entre cada ejecución del trabajo. Para obtener más información, vea sp_add_schedule (Transact-SQL).

freq_relative_interval

int

Repeticiones del freq_interval del trabajo programado cada mes. Para obtener más información, vea sp_add_schedule (Transact-SQL).

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 que se deriva 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 en que la programación hará que se vuelva a ejecutar el trabajo.

next_run_time

int

Hora a la que la programación hará que se vuelva a ejecutar 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 tablas del sistema dbo.sysjobschedules y dbo.sysschedules en msdb. sysjobschedules se actualiza 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 utilizar en algunas combinaciones. Si se especifica schedule_id, no puede especificarse ni job_id ni job_name. De lo contrario, los parámetros job_id o job_name pueden utilizarse con schedule_name.

Permisos

Requiere la pertenencia al rol fijo de servidor sysadmin. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL Server en la base de datos msdb:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

Los miembros de SQLAgentUserRole solo pueden ver las propiedades de las programaciones de los trabajos que les pertenecen.

Ejemplos

A.Devolver la programación de 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 de un 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 de un trabajo y la descripció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

Vea también

Referencia

sp_add_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_update_schedule (Transact-SQL)

Procedimientos almacenados del sistema (Transact-SQL)