sp_add_schedule(Transact-SQL)

아티클
06/18/2013

여러 작업에서 사용할 수 있는 일정을 만듭니다.

구문

sp_add_schedule [ @schedule_name = ] 'schedule_name' 
    [ , [ @enabled = ] enabled ]
    [ , [ @freq_type = ] freq_type ]
    [ , [ @freq_interval = ] freq_interval ] 
    [ , [ @freq_subday_type = ] freq_subday_type ] 
    [ , [ @freq_subday_interval = ] freq_subday_interval ] 
    [ , [ @freq_relative_interval = ] freq_relative_interval ] 
    [ , [ @freq_recurrence_factor = ] freq_recurrence_factor ] 
    [ , [ @active_start_date = ] active_start_date ] 
    [ , [ @active_end_date = ] active_end_date ] 
    [ , [ @active_start_time = ] active_start_time ] 
    [ , [ @active_end_time = ] active_end_time ] 
    [ , [ @owner_login_name = ] 'owner_login_name' ]
    [ , [ @schedule_uid = ] schedule_uid OUTPUT ]
    [ , [ @schedule_id = ] schedule_id OUTPUT ]
    [ , [ @originating_server = ] server_name ] /* internal */

인수

[ @schedule_name = ] 'schedule_name'
일정의 이름입니다. schedule_name은 sysname이며 기본값은 없습니다.
[ @enabled = ] enabled
일정의 현재 상태를 나타냅니다. enabled는 tinyint이며 기본값은 1(사용)입니다. 0이 지정되어 있는 경우에는 일정을 사용할 수 없습니다. 일정을 사용할 수 없는 경우 이 일정에 따라 어떠한 작업도 실행되지 않습니다.

[ @freq_type = ] freq_type
작업이 실행될 시기를 나타내는 값입니다. freq_type은 int이고 기본값은 0이며 다음 값 중 하나를 사용할 수 있습니다.

값	설명
1	한 번
4	매일
8	매주
16	매월
32	매월(freq_interval에 상대적임)
64	SQLServerAgent 서비스를 시작할 때 실행
128	컴퓨터가 유휴 상태일 때 실행

[ @freq_interval = ] freq_interval
작업이 실행되는 날짜입니다. freq_interval은 int이고 기본값은 1이며 freq_type의 값에 따라 달라집니다.

freq_type의 값	freq_interval에 미치는 영향
1(한 번)	freq_interval이 사용되지 않습니다.
4(매일)	매 freq_interval일
8(매주)	freq_interval은 다음 중 하나 이상이 될 수 있습니다. 이 경우 OR 논리 연산자와 함께 사용할 수 있습니다. 1 = 일요일 2 = 월요일 4 = 화요일 8 = 수요일 16 = 목요일 32 = 금요일 64 = 토요일
16(매월)	월 중 freq_interval일
32(매월 상대적)	freq_interval은 다음 중 하나일 수 있습니다. 1 = 일요일 2 = 월요일 3 = 화요일 4 = 수요일 5 = 목요일 6 = 금요일 7 = 토요일 8 = 일 9 = 평일 10 = 주말
64(SQLServerAgent 서비스를 시작할 때)	freq_interval이 사용되지 않습니다.
128	freq_interval이 사용되지 않습니다.

[ @freq_subday_type = ] freq_subday_type
freq_subday_interval의 단위를 지정합니다. freq_subday_type은 int이고 기본값은 0이며 다음 값 중 하나를 사용할 수 있습니다.

값

설명(단위)

0x1

지정된 시간

0x2

초

0x4

분

0x8

시간
[ @freq_subday_interval = ] freq_subday_interval
각 작업 실행 간에 발생할 freq_subday_type 기간의 일 수입니다. freq_subday_interval는 int이며 기본값은 0입니다. 참고: 간격은 10초보다 길어야 합니다. freq_subday_type이 1인 경우 freq_subday_interval은 무시됩니다.
[ @freq_relative_interval = ] freq_relative_interval
freq_interval이 32(매월 상대적)인 경우 매월 freq_interval 기간의 작업 발생 횟수입니다. freq_relative_interval은 int이고 기본값은 0이며 다음 값 중 하나를 사용할 수 있습니다. freq_type이 32가 아닌 경우 freq_relative_interval이 무시됩니다.

값

설명(단위)

1

첫째

2

둘째

4

셋째

8

넷째

16

마지막
[ @freq_recurrence_factor = ] freq_recurrence_factor
예약된 작업 실행 간에 발생하는 주 또는 월의 수입니다. freq_recurrence_factor는 freq_type이 8, 16 또는 32인 경우에만 사용됩니다. freq_recurrence_factor는 int이며 기본값은 0입니다.
[ @active_start_date = ] active_start_date
작업 실행이 시작되는 날짜입니다. active_start_date는 int이며 기본값은 오늘 날짜를 나타내는 NULL입니다. 날짜 형식은 YYYYMMDD입니다. active_start_date가 NULL이 아닌 경우에는 반드시 날짜가 19900101 이후여야 합니다.

일정을 만든 다음 시작 날짜를 검토하여 날짜가 제대로 되어 있는지 확인하십시오. 자세한 내용은 일정을 만들고 작업에 연결의 "시작 날짜 예약" 섹션을 참조하십시오.

주별 또는 월별 일정의 경우 에이전트는 active_start_date가 과거 날짜인 경우 이를 무시하고 대신 현재 날짜를 사용합니다. sp_add_schedule을 사용하여 SQL 에이전트 일정을 만드는 경우 작업 실행이 시작되는 날짜인 active_start_date 매개 변수를 지정할 수 있습니다. 일정 유형이 주별이거나 월별이고 active_start_date 매개 변수가 과거 날짜로 설정되는 경우 active_start_date 매개 변수는 무시되고 현재 날짜가 active_start_date로 사용됩니다.
[ @active_end_date = ] active_end_date
작업 실행이 중지되는 날짜입니다. active_end_date는 int이며 기본값은 9999년 12월 31일을 나타내는 99991231입니다. 날짜 형식은 YYYYMMDD입니다.
[ @active_start_time = ] active_start_time
active_start_date와 active_end_date 사이의 임의의 날짜에서 작업 실행이 시작되는 시간입니다. active_start_time은 int이며 기본값은 24시간제로 오전 12시를 나타내는 000000입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.
[ @active_end_time = ] active_end_time
active_start_date와 active_end_date 사이의 임의의 날짜에서 작업 실행을 종료할 시간입니다. active_end_time은 int이며 기본값은 24시간 기준으로 오후 11:59:59를 가리키는 235959입니다. 이때 시간은 HHMMSS 형식으로 입력해야 합니다.
[ @owner_login_name= ] 'owner_login_name'
일정을 소유하는 서버 보안 주체의 이름입니다. owner_login_name은 sysname이며 기본값은 작성자가 일정을 소유하고 있음을 나타내는 NULL입니다.
[ @schedule_uid= ] schedule_uidOUTPUT
일정의 고유 식별자입니다. schedule_uid는 uniqueidentifier 유형의 변수입니다.
[ @schedule_id= ] schedule_idOUTPUT
일정에 대한 식별자입니다. schedule_id는 int 유형의 변수입니다.
[ @originating_server= ] server_name
정보를 제공하기 위해서만 확인됩니다. 지원되지 않습니다. 향후 호환성은 보장되지 않습니다.

값	설명(단위)
0x1	지정된 시간
0x2	초
0x4	분
0x8	시간

값	설명(단위)
1	첫째
2	둘째
4	셋째
8	넷째
16	마지막

반환 코드 값

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

결과 집합

없음

주의

SQL Server Management Studio는 작업 구조를 만들고 관리할 수 있는 바람직한 방법을 제공하는데 이는 그래픽을 사용하여 쉽게 작업을 관리할 수 있는 방법입니다.

사용 권한

기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.

SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole

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

예

1.일정 만들기

다음 예에서는 RunOnce라는 일정을 만듭니다. 일정은 일정이 생성된 날짜의 23:30에 한 번 실행됩니다.

USE msdb ;
GO

EXEC dbo.sp_add_schedule
    @schedule_name = N'RunOnce',
    @freq_type = 1,
    @active_start_time = 233000 ;

GO

2.일정 만들기, 여러 작업에 일정 연결

다음 예에서는 NightlyJobs라는 일정을 만듭니다. 서버 시간이 01:00일 때 이 일정을 사용하는 작업이 매일 실행됩니다. 이 예에서는 BackupDatabase 작업과 RunReports 작업에 일정을 연결합니다.

[!참고]

이 예에서는 BackupDatabase 작업 및 RunReports 작업이 이미 있다고 가정합니다.

USE msdb ;
GO

EXEC sp_add_schedule
    @schedule_name = N'NightlyJobs' ,
    @freq_type = 4,
    @freq_interval = 1,
    @active_start_time = 010000 ;
GO


EXEC sp_attach_schedule
   @job_name = N'BackupDatabase',
   @schedule_name = N'NightlyJobs' ;
GO

EXEC sp_attach_schedule
   @job_name = N'RunReports',
   @schedule_name = N'NightlyJobs' ;
GO