sp_help_jobs_in_schedule(Transact-SQL)

특정 일정이 연결된 작업에 대한 정보를 반환합니다.

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

구문

sp_help_jobs_in_schedule 
     [ @schedule_name = ] 'schedule_name' ,
     [ @schedule_id = ] schedule_id

인수

  • [ @schedule_id = ] schedule_id
    정보를 나열할 일정의 식별자입니다. schedule_id는 int이며 기본값은 없습니다. schedule_id 또는 schedule_name을 지정할 수 있습니다.

  • [ @schedule_name = ] 'schedule_name'
    정보를 나열할 일정의 이름입니다. schedule_name은 sysname이며 기본값은 없습니다. schedule_id 또는 schedule_name을 지정할 수 있습니다.

반환 코드 값

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

결과 집합

다음 결과 집합을 반환합니다.

열 이름

데이터 형식

설명

job_id

uniqueidentifier

작업의 고유 ID입니다.

originating_server

nvarchar(30)

작업을 가져온 서버의 이름입니다.

name

sysname

작업의 이름입니다.

enabled

tinyint

작업을 실행할 수 있는지를 표시합니다.

description

nvarchar(512)

작업 설명입니다.

start_step_id

int

실행을 시작해야 하는 작업 단계의 ID입니다.

category

sysname

작업 범주입니다.

owner

sysname

작업 소유자입니다.

notify_level_eventlog

int

Microsoft Windows 응용 프로그램 로그에 알림 이벤트를 기록해야 하는 상황을 나타내는 비트 마스크입니다. 다음 값 중 하나를 사용할 수 있습니다.

0 = 안 함

1 = 작업이 성공할 경우

2 = 작업이 실패할 경우

3 = 작업이 완료될 때마다(작업 결과와 무관)

notify_level_email

int

작업을 완료했을 때, 어떤 상황에서 알림 전자 메일을 전달해야 할지를 지정하는 비트 마스크입니다. 가능한 값은 notify_level_eventlog와 같습니다

notify_level_netsend

int

작업을 완료했을 때, 어떤 상황에서 네트워크 메시지를 전달해야 할지를 지정하는 비트 마스크입니다. 가능한 값은 notify_level_eventlog와 같습니다

notify_level_page

int

작업을 완료했을 때, 어떤 상황에서 메시지를 보내야 할지를 지정하는 비트 마스크입니다. 가능한 값은 notify_level_eventlog와 같습니다

notify_email_operator

sysname

정보를 알릴 운영자의 전자 메일 이름입니다.

notify_netsend_operator

sysname

네트워크 메시지를 전달할 때 사용하는 컴퓨터 또는 사용자의 이름입니다.

notify_page_operator

sysname

네트워크 메시지를 전달할 때 사용하는 컴퓨터 또는 사용자의 이름입니다.

delete_level

int

작업을 완료했을 때, 어떤 상황에서 작업을 삭제해야 할지를 지정하는 비트 마스크입니다. 가능한 값은 notify_level_eventlog와 같습니다.

date_created

datetime

작업을 만든 날짜입니다.

date_modified

datetime

작업을 마지막으로 수정한 날짜입니다.

version_number

int

작업의 버전입니다. 작업이 수정될 때마다 자동으로 업데이트됩니다.

last_run_date

int

작업이 마지막으로 실행을 시작한 날짜입니다.

last_run_time

int

작업이 마지막으로 실행을 시작한 시간입니다.

last_run_outcome

int

작업이 마지막으로 실행되었을 때의 결과입니다.

0 = 실패

1 = 성공

3 = 취소됨

5 = 알 수 없음

next_run_date

int

다음 작업 실행 일정의 날짜입니다.

next_run_time

int

다음 작업 실행 일정의 시간입니다.

next_run_schedule_id

int

다음 실행 일정의 ID입니다.

current_execution_status

int

현재 실행 상태입니다.

current_execution_step

sysname

작업의 현재 실행 단계입니다.

current_retry_attempt

int

작업이 실행 중이며 단계가 다시 시도된 경우의 현재 재시도입니다.

has_step

int

작업이 갖고 있는 단계 수입니다.

has_schedule

int

작업이 갖고 있는 작업 일정 수입니다.

has_target

int

작업이 갖고 있는 대상 서버 수입니다.

유형

int

작업의 유형입니다.

1 = 로컬 작업

2 = 다중 서버 작업

0 = 작업에 대상 서버가 없음

주의

이 프로시저는 지정한 일정에 연결된 작업에 대한 정보를 나열합니다.

사용 권한

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

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

SQLAgentUserRole의 멤버는 각자 소유한 작업의 상태만 볼 수 있습니다.

다음 예에서는 NightlyJobs 일정에 연결된 작업을 나열합니다.

USE msdb ;
GO

EXEC sp_help_jobs_in_schedule
    @schedule_name = N'NightlyJobs' ;
GO

참고 항목

참조

SQL Server 에이전트 저장 프로시저(Transact-SQL)

sp_add_schedule(Transact-SQL)

sp_attach_schedule(Transact-SQL)

sp_delete_schedule(Transact-SQL)

sp_detach_schedule(Transact-SQL)