sp_help_schedule(Transact-SQL)
일정에 관한 정보를 나열합니다.
구문
sp_help_schedule [ @schedule_id = ] id ,
[ @schedule_name = ] 'schedule_name'
[ , [ @attached_schedules_only = ] attached_schedules_only ]
[ , [ @include_description = ] include_description ]
인수
- [ @schedule_id = ] id
나열할 일정의 식별자입니다. schedule_name은 int이며 기본값은 없습니다. schedule_id 또는 schedule_name을 지정할 수 있습니다.
- [ @schedule_name = ] 'schedule_name'
나열할 일정의 이름입니다. schedule_name은 sysname이며 기본값은 없습니다. schedule_id 또는 schedule_name을 지정할 수 있습니다.
- [ @attached_schedules_only = ] attached_schedules_only ]
작업이 연결되어 있는 일정만 표시할지 여부를 지정합니다. attached_schedules_only는 bit이며 기본값은 0입니다. attached_schedules_only가 0이면 모든 일정이 표시됩니다. attached_schedules_only가 1이면 작업에 연결되어 있는 일정만 결과 집합에 포함됩니다.
- [ @include_description = ] include_description
결과 집합에 설명을 포함할지 여부를 지정합니다. include_description은 bit이며 기본값은 0입니다. include_description이 0이면 결과 집합의 schedule_description 열에 자리 표시자가 포함됩니다. include_description이 1일 경우에는 일정 설명이 결과 집합에 포함됩니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
이 프로시저는 다음 결과 집합을 반환합니다.
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
schedule_id |
int |
일정 ID입니다. |
schedule_uid |
uniqueidentifier |
일정에 대한 식별자입니다. |
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) |
일정에 관한 영어 설명입니다(요청된 경우에 한함). |
job_count |
int |
이 일정을 참조하는 작업 수를 반환합니다. |
주의
매개 변수가 제공되지 않은 경우 sp_help_schedule은 인스턴스에 있는 모든 일정에 대한 정보를 나열합니다.
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
SQLAgentUserRole의 멤버는 각자 소유한 일정만 볼 수 있습니다.
예
1. 인스턴스의 모든 일정에 대한 정보 나열
다음 예에서는 인스턴스에 있는 모든 일정에 대한 정보를 나열합니다.
USE msdb ;
GO
EXEC dbo.sp_help_schedule ;
GO
2. 특정 일정에 대한 정보 나열
다음 예에서는 NightlyJobs라는 일정에 대한 정보를 나열합니다.
USE msdb ;
GO
EXEC dbo.sp_help_schedule
@schedule_name = N'NightlyJobs' ;
GO
참고 항목
참조
sp_add_schedule(Transact-SQL)
sp_attach_schedule(Transact-SQL)
sp_delete_schedule(Transact-SQL)
sp_detach_schedule(Transact-SQL)