다음을 통해 공유


sp_help_jobschedule(Transact-SQL)

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

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

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_jobschedulemsdbdbo.sysjobschedulesdbo.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