sp_help_jobschedule (Transact-SQL)sp_help_jobschedule (Transact-SQL)

Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions) Se aplica a:Applies to: síSQL ServerSQL Server (todas las versiones admitidas) yesSQL ServerSQL Server (all supported versions)

Devuelve información acerca de la programación de los trabajos que SQL Server Management StudioSQL Server Management Studio utiliza para realizar actividades automatizadas.Returns information about the scheduling of jobs used by SQL Server Management StudioSQL Server Management Studio to perform automated activities.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

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

ArgumentosArguments

[ @job_id = ] job_id El número de identificación del trabajo.[ @job_id = ] job_id The job identification number. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL.job_id is uniqueidentifier, with a default of NULL.

[ @job_name = ] 'job_name' Nombre del trabajo.[ @job_name = ] 'job_name' The name of the job. job_name es de tipo sysname y su valor predeterminado es NULL.job_name is sysname, with a default of NULL.

Nota

Se debe especificar job_id o job_name , pero no se pueden especificar ambos.Either job_id or job_name must be specified, but both cannot be specified.

[ @schedule_name = ] 'schedule_name' Nombre del elemento de programación del trabajo.[ @schedule_name = ] 'schedule_name' The name of the schedule item for the job. schedule_name es de tipo sysname y su valor predeterminado es NULL.schedule_name is sysname, with a default of NULL.

[ @schedule_id = ] schedule_id Número de identificación del elemento de programación del trabajo.[ @schedule_id = ] schedule_id The identification number of the schedule item for the job. schedule_id es de tipo int y su valor predeterminado es NULL.schedule_id is int, with a default of NULL.

[ @include_description = ] include_description Especifica si se debe incluir la descripción de la programación en el conjunto de resultados.[ @include_description = ] include_description Specifies whether to include the description of the schedule in the result set. include_description es de bit y su valor predeterminado es 0.include_description is bit, with a default of 0. Cuando include_description es 0, la descripción de la programación no se incluye en el conjunto de resultados.When include_description is 0, the description of the schedule is not included in the result set. Cuando include_description es 1, la descripción de la programación se incluye en el conjunto de resultados.When include_description is 1, the description of the schedule is included in the result set.

Valores de código de retornoReturn Code Values

0 (correcto) o 1 (error)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Nombre de la columnaColumn name Tipo de datosData type DescripciónDescription
schedule_idschedule_id intint Número de identificador de la programación.Schedule identifier number.
schedule_nameschedule_name sysnamesysname Nombre de la programación.Name of the schedule.
enabledenabled intint Indica si la programación está habilitada (1) o no (0).Whether the schedule enabled (1) or not enabled (0).
freq_typefreq_type intint Valor que indica cuándo se va a ejecutar el trabajo.Value indicating when the job is to be executed.

1 = una vez1 = Once

4 = diariamente4 = Daily

8 = semanalmente8 = Weekly

16 = mensualmente16 = Monthly

32 = mensualmente, con respecto al freq_interval32 = Monthly, relative to the freq_interval

64 = ejecutar cuando se inicia el servicio SQLServerAgent .64 = Run when SQLServerAgent service starts.
freq_intervalfreq_interval intint Días en que se ejecuta el trabajo.Days when the job is executed. El valor depende del valor de freq_type.The value depends on the value of freq_type. Para obtener más información, vea sp_add_schedule ()de Transact-SQL .For more information, see sp_add_schedule (Transact-SQL).
freq_subday_typefreq_subday_type intint Unidades para freq_subday_interval.Units for freq_subday_interval. Para obtener más información, vea sp_add_schedule ()de Transact-SQL .For more information, see sp_add_schedule (Transact-SQL).
freq_subday_intervalfreq_subday_interval intint Número de períodos de freq_subday_type entre cada ejecución del trabajo.Number of freq_subday_type periods to occur between each execution of the job. Para obtener más información, vea sp_add_schedule ()de Transact-SQL .For more information, see sp_add_schedule (Transact-SQL).
freq_relative_intervalfreq_relative_interval intint Repetición del trabajo programado del freq_interval cada mes.Scheduled job's occurrence of the freq_interval in each month. Para obtener más información, vea sp_add_schedule ()de Transact-SQL .For more information, see sp_add_schedule (Transact-SQL).
freq_recurrence_factorfreq_recurrence_factor intint Número de meses entre las ejecuciones programadas del trabajo.Number of months between the scheduled execution of the job.
active_start_dateactive_start_date intint Fecha en que se activó la programación.Date the schedule is activated.
active_end_dateactive_end_date intint Fecha final de la programación.End date of the schedule.
active_start_timeactive_start_time intint Hora del día en que se inicia la programación.Time of the day the schedule starts.
active_end_timeactive_end_time intint Hora del día en que termina la programación.Time of the day schedule ends.
date_createddate_created datetimedatetime Fecha en que se creó la programación.Date the schedule is created.
schedule_descriptionschedule_description nvarchar(4000)nvarchar(4000) Una descripción en Inglés de la programación que se deriva de los valores de las programaciones demsdb.dbo.sys.An English description of the schedule that is derived from values in msdb.dbo.sysschedules. Cuando include_description es 0, esta columna contiene texto que indica que no se solicitó la descripción.When include_description is 0, this column contains text stating that the description was not requested.
next_run_datenext_run_date intint Fecha en que la programación hará que se vuelva a ejecutar el trabajo.Date the schedule will next cause the job to run.
next_run_timenext_run_time intint Hora a la que la programación hará que se vuelva a ejecutar el trabajo.Time the schedule will next cause the job to run.
schedule_uidschedule_uid uniqueidentifieruniqueidentifier Identificador de la programación.Identifier for the schedule.
job_countjob_count intint Recuento de trabajos devueltos.Count of jobs returned.

Nota: sp_help_jobschedule devuelve valores del dbo.sysjobschedules y dbo.sysprograma las tablas del sistema en msdb.NOTE: sp_help_jobschedule returns values from the dbo.sysjobschedules and dbo.sysschedules system tables in msdb. sysjobschedules se actualiza cada 20 minutos.sysjobschedules updates every 20 minutes. Esto puede afectar a los valores devueltos por este procedimiento almacenado.This might affect the values that are returned by this stored procedure.

ObservacionesRemarks

Los parámetros de sp_help_jobschedule solo se pueden utilizar en determinadas combinaciones.The parameters of sp_help_jobschedule can be used only in certain combinations. Si se especifica schedule_id , no se puede especificar ni job_id ni job_name .If schedule_id is specified, neither job_id nor job_name can be specified. De lo contrario, los parámetros job_id o job_name se pueden usar con schedule_name.Otherwise, the job_id or job_name parameters can be used with schedule_name.

PermisosPermissions

Requiere la pertenencia al rol fijo de servidor sysadmin .Requires membership in the sysadmin fixed server role. Al resto de usuarios se les debe conceder uno de los siguientes roles fijos de base de datos del Agente SQL ServerSQL Server en la base de datos msdb :Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

Para detalles sobre los permisos de estos roles, consulte Roles fijos de base de datos del Agente SQL Server.For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

Los miembros de SQLAgentUserRole solo pueden ver las propiedades de las programaciones de trabajos que les pertenecen.Members of SQLAgentUserRole can only view properties of job schedules that they own.

EjemplosExamples

A.A. Devolver la programación de un trabajo específicoReturning the job schedule for a specific job

En el ejemplo siguiente se devuelve información de la programación de un trabajo denominado BackupDatabase.The following example returns the scheduling information for a job named BackupDatabase.

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

B.B. Devolver la programación de un trabajo para una programación específicaReturning the job schedule for a specific schedule

En el ejemplo siguiente se devuelve información de la programación denominada NightlyJobs y el trabajo denominado RunReports.The following example returns the information for the schedule named NightlyJobs and the job named RunReports.

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

C.C. Devolver la programación de un trabajo y la descripción de una programación específicaReturning the job schedule and schedule description for a specific schedule

En el ejemplo siguiente se devuelve información de la programación denominada NightlyJobs y el trabajo denominado RunReports.The following example returns the information for the schedule named NightlyJobs and the job named RunReports. El conjunto de resultados devuelto incluye una descripción de la programación.The result set returned includes a description of the schedule.

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

Consulte tambiénSee Also

sp_add_schedule ()de Transact-SQL sp_add_schedule (Transact-SQL)
sp_delete_schedule ()de Transact-SQL sp_delete_schedule (Transact-SQL)
sp_update_schedule ()de Transact-SQL sp_update_schedule (Transact-SQL)
Procedimientos almacenados del sistema (Transact-SQL)System Stored Procedures (Transact-SQL)