sp_help_jobschedule(Transact-SQL)
SQL Server Management Studio가 자동화된 작업을 수행하는 데 사용하는 작업의 일정에 관한 정보를 반환합니다.
구문
sp_help_jobschedule { [ @job_id = ] job_id | [ @job_name = ] 'job_name' }
[ , [ @schedule_name = ] 'schedule_name' ]
[ , [ @schedule_id = ] schedule_id ]
[ , [ @include_description = ] include_description ]
인수
[ @job_id= ] job_id
작업 ID입니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.[ @job_name= ] 'job_name'
작업 이름입니다. job_name은 sysname이며 기본값은 NULL입니다.[!참고]
job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다.
[ @schedule_name= ] 'schedule_name'
작업에 대한 일정 항목의 이름입니다. schedule_name은 sysname이며 기본값은 NULL입니다.[ @schedule_id= ] schedule_id
작업에 대한 일정 항목의 ID입니다. schedule_id는 int이며 기본값은 NULL입니다.[ @include_description= ] include_description
결과 집합에 일정에 대한 설명을 포함할지 여부를 지정합니다. include_description은 bit이며 기본값은 0입니다. include_description이 0인 경우 일정에 대한 설명이 결과 집합에 포함되지 않습니다. include_description이 1인 경우에는 일정에 대한 설명이 결과 집합에 포함됩니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
열 이름 |
데이터 형식 |
설명 |
---|---|---|
schedule_id |
int |
일정 ID입니다. |
schedule_name |
sysname |
일정 이름입니다. |
enabled |
int |
일정을 사용할지(1) 또는 사용하지 않을지(0) 지정합니다. |
freq_type |
int |
작업을 실행할 때를 지정하는 값입니다. 1 = 1회 4 = 매일 8 = 매주 16 = 매월 32 = 매월(freq_interval에 상대적임) 64 = SQLServerAgent 서비스를 시작할 때 실행 |
freq_interval |
int |
작업이 실행되는 요일입니다. 값은 freq_type의 값에 따라 달라집니다. 자세한 내용은 sp_add_schedule(Transact-SQL)을 참조하십시오. |
freq_subday_type |
int |
freq_subday_interval의 단위입니다. 자세한 내용은 sp_add_schedule(Transact-SQL)을 참조하십시오. |
freq_subday_interval |
int |
작업 실행 사이에 발생하는 freq_subday_type 기간의 개수입니다. 자세한 내용은 sp_add_schedule(Transact-SQL)을 참조하십시오. |
freq_relative_interval |
int |
매월 예약된 작업에서 freq_interval의 발생 빈도입니다. 자세한 내용은 sp_add_schedule(Transact-SQL)을 참조하십시오. |
freq_recurrence_factor |
int |
작업의 예약된 실행 간의 개월 수입니다. |
active_start_date |
int |
일정을 활성화하는 날짜입니다. |
active_end_date |
int |
일정을 종료하는 날짜입니다. |
active_start_time |
int |
일정을 시작하는 시간입니다. |
active_end_time |
int |
일정을 종료하는 시간입니다. |
date_created |
datetime |
일정을 만든 날짜입니다. |
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은 msdb의 dbo.sysjobschedules 및 dbo.sysschedules 시스템 테이블에서 값을 반환합니다. sysjobschedules는 20초마다 업데이트됩니다. 이는 저장 프로시저에서 반환하는 값에 영향을 줄 수 있습니다.
주의
sp_help_jobschedule의 매개 변수는 특정 조합에서만 사용할 수 있습니다. schedule_id를 지정한 경우에는 job_id 또는 job_name을 지정할 수 없습니다. 그렇지 않은 경우에는 job_id 또는 job_name 매개 변수를 schedule_name과 함께 사용할 수 있습니다.
사용 권한
sysadmin 고정 서버 역할의 멤버 자격이 필요합니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
SQLAgentUserRole의 멤버는 각자 소유한 작업 일정의 속성만 볼 수 있습니다.
예
1. 특정 작업에 대한 작업 일정 반환
다음 예에서는 BackupDatabase라는 작업에 관한 일정 정보를 반환합니다.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'BackupDatabase' ;
GO
2. 특정 일정에 대한 작업 일정 반환
다음 예에서는 NightlyJobs라는 일정과 RunReports라는 작업에 관한 정보를 반환합니다.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs' ;
GO
3. 특정 일정에 대한 작업 일정 및 일정 설명 반환
다음 예에서는 NightlyJobs라는 일정과 RunReports라는 작업에 관한 정보를 반환합니다. 반환된 결과 집합에는 일정 설명이 포함됩니다.
USE msdb ;
GO
EXEC dbo.sp_help_jobschedule
@job_name = N'RunReports',
@schedule_name = N'NightlyJobs',
@include_description = 1 ;
GO