sp_help_jobschedule(Transact-SQL)
적용 대상:SQL Server
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 기본값이 NULL인 uniqueidentifier입니다.
[ @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 기본값이 NULL인 int입니다.
[ @include_description = ] include_description
결과 집합에 일정에 대한 설명을 포함할지 여부를 지정합니다. include_description 비트이며 기본값은 0입니다. include_description 0이면 일정에 대한 설명이 결과 집합에 포함되지 않습니다. include_description 1이면 일정에 대한 설명이 결과 집합에 포함됩니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
열 이름 | 데이터 형식 | 설명 |
---|---|---|
schedule_id | int | 식별자 번호를 예약합니다. |
schedule_name | sysname | 일정의 이름입니다. |
사용 | int | 일정 사용 여부(1) 사용 여부(0). |
freq_type | int | 작업을 실행할 시기를 나타내는 값입니다. 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 고정 서버 역할의 멤버 자격이 필요합니다. 다른 사용자는 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
참고 항목
sp_add_schedule(Transact-SQL)
sp_delete_schedule(Transact-SQL)
sp_update_schedule(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기