다음을 통해 공유

sp_help_jobschedule(Transact-SQL)

  • 아티클

적용 대상: SQL Server

SQL Server Management Studio에서 자동화된 작업을 수행하는 데 사용하는 작업의 예약에 대한 정보를 반환합니다.

Transact-SQL 구문 표기 규칙

구문

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 ]
[ ; ]

인수

[ @job_id = ] 'job_id'

작업 ID 번호입니다. @job_id 기본값NULL인 uniqueidentifier입니다.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @job_name = ] N'job_name'

작업의 이름입니다. @job_name sysname이며 기본값은 .입니다NULL.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @schedule_name = ] N'schedule_name'

작업에 대한 일정 항목의 이름입니다. @schedule_name sysname이며 기본값은 .입니다NULL.

[ @schedule_id = ] schedule_id

작업에 대한 일정 항목의 ID 번호입니다. @schedule_id 기본값NULL인 int입니다.

[ @include_description = ] include_description

결과 집합에 일정에 대한 설명을 포함할지 여부를 지정합니다. @include_description 비트이며 기본값은 .입니다0.

  • 이 경우 0일정에 대한 설명이 결과 집합에 포함되지 않습니다.
  • 이 경우 1일정에 대한 설명이 결과 집합에 포함됩니다.

반환 코드 값

0 (성공) 또는 1 (실패).

결과 집합

열 이름 데이터 형식 설명
schedule_id int 식별자 번호를 예약합니다.
schedule_name sysname 일정의 이름입니다.
enabled int 일정 사용 여부() 사용 여부(10).
freq_type int 작업을 실행할 시기를 나타내는 값입니다.

1 = 한 번
4 = 매일
8 = 매주
16 = 매월
32 = 월별로, freq_interval
64= SQL Server 에이전트 서비스가 시작될 때 실행됩니다.
freq_interval int 작업이 실행되는 요일입니다. 값은 의 값 freq_type에 따라 달라집니다. 자세한 내용은 sp_add_schedule 참조하세요.
freq_subday_type int 에 대한 단위입니다 freq_subday_interval. 자세한 내용은 sp_add_schedule 참조하세요.
freq_subday_interval int freq_subday_type 작업의 각 실행 사이에 발생할 기간 수입니다. 자세한 내용은 sp_add_schedule 참조하세요.
freq_relative_interval int 예약된 작업의 매월 발생 횟수 freq_interval 입니다. 자세한 내용은 sp_add_schedule 참조하세요.
freq_recurrence_factor int 예약된 작업 실행 사이의 개월 수입니다.
active_start_date int 일정을 활성화하는 날짜입니다.
active_end_date int 일정의 종료 날짜입니다.
active_start_time int 일정이 시작되는 시간입니다.
active_end_time int 하루 일정의 시간이 종료됩니다.
date_created 날짜/시간 일정을 만든 날짜입니다.
schedule_description nvarchar(4000) 의 값 msdb.dbo.sysschedules에서 파생된 일정에 대한 영어 설명입니다. @include_description 이 0열에는 설명이 요청되지 않았다는 내용의 텍스트가 포함됩니다.
next_run_date int 다음 일정으로 인해 작업이 실행되도록 날짜 지정합니다.
next_run_time int 다음 일정으로 인해 작업이 실행되도록 하는 시간입니다.
schedule_uid uniqueidentifier 일정의 식별자입니다.
job_count int 반환된 작업 수입니다.

참고 항목

sp_help_jobschedule는 20분마다 업데이트의 msdb.sysjobschedules 시스템 테이블 및 dbo.sysschedules 값 dbo.sysjobschedules 이 반환됩니다. 이는 저장 프로시저에서 반환하는 값에 영향을 줄 수 있습니다.

설명

매개 변수 sp_help_jobschedule 는 특정 조합에서만 사용할 수 있습니다. @schedule_id 지정한 경우 @job_id 및 @job_name 지정할 수 없습니다. 그렇지 않으면 @job_id 또는 @job_name 매개 변수를 @schedule_name 사용할 수 있습니다.

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

다른 사용자에게는 데이터베이스에서 다음 SQL Server 에이전트 고정 데이터베이스 역할 msdb 중 하나가 부여되어야 합니다.

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하세요.

SQLAgentUserRole의 멤버는 자신이 소유한 작업 일정의 속성만 볼 수 있습니다.

예제

A. 특정 작업에 대한 작업 일정을 반환합니다.

다음 예제에서는 이름이 지정된 BackupDatabase작업에 대한 예약 정보를 반환합니다.

USE msdb;
GO

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

B. 특정 일정에 대한 작업 일정을 반환합니다.

다음 예제에서는 명명된 일정과 이름이 지정된 NightlyJobs RunReports작업에 대한 정보를 반환합니다.

USE msdb;
GO

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

C. 특정 일정에 대한 작업 일정 및 일정 설명을 반환합니다.

다음 예제에서는 명명된 일정과 이름이 지정된 NightlyJobs RunReports작업에 대한 정보를 반환합니다. 반환된 결과 집합에는 일정에 대한 설명이 포함됩니다.

USE msdb;
GO

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

관련 콘텐츠