다음을 통해 공유


sp_help_jobstep(Transact-SQL)

SQL Server 에이전트 서비스가 자동화된 작업을 수행하는 데 사용하는 작업의 단계에 대한 정보를 반환합니다.

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

구문

sp_help_jobstep { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }
     [ , [ @step_id = ] step_id ] 
     [ , [ @step_name = ] 'step_name' ] 
     [ , [ @suffix = ] suffix ] 

인수

  • [ @job_id =] 'job_id'
    작업 정보를 반환할 작업의 ID입니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.

  • [ @job_name =] 'job_name'
    작업 이름입니다. job_name은 sysname이며 기본값은 NULL입니다.

    [!참고]

    job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다.

  • [ @step_id =] step_id
    작업 단계의 ID입니다. 지정하지 않은 경우 작업의 모든 단계가 포함됩니다. step_id는 int이며 기본값은 NULL입니다.

  • [ @step_name =] 'step_name'
    작업 단계의 이름입니다. step_name은 sysname이며 기본값은 NULL입니다.

  • [ @suffix =] suffix
    텍스트 설명이 출력의 flags 열에 추가되는지 여부를 나타내는 플래그입니다. suffix는 bit이며 기본값은 0입니다. suffix가 1이면 설명이 추가됩니다.

반환 코드 값

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

결과 집합

열 이름

데이터 형식

설명

step_id

int

단계의 고유 식별자입니다.

step_name

sysname

작업 단계의 이름입니다.

subsystem

nvarchar(40)

단계 명령을 실행할 하위 시스템입니다.

command

nvarchar(max)

단계에서 실행할 명령입니다.

flags

int

단계 동작을 제어하는 값의 비트 마스크입니다.

cmdexec_success_code

int

CmdExec 단계의 경우 성공한 명령의 프로세스 종료 코드입니다.

on_success_action

tinyint

단계가 성공할 경우 수행되는 동작입니다.

1 = 성공 보고와 함께 작업 종료

2 = 실패 보고와 함께 작업 종료

3 = 다음 단계로 이동

4 = 단계로 이동

on_success_step_id

int

on_success_action이 4인 경우 실행할 다음 단계를 표시합니다.

on_fail_action

tinyint

단계가 실패할 경우 수행되는 작업입니다. 값은 on_success_action과 같습니다.

on_fail_step_id

int

on_fail_action이 4인 경우 실행할 다음 단계를 표시합니다.

server

sysname

예약되어 있습니다.

database_name

sysname

Transact-SQL 단계의 경우 명령이 실행되는 데이터베이스입니다.

database_user_name

sysname

Transact-SQL 단계의 경우 명령이 실행되는 데이터베이스 사용자 컨텍스트입니다.

retry_attempts

int

단계가 성공하지 못한 경우에 명령을 재시도할 최대 횟수입니다.

retry_interval

int

재시도 간격(분)입니다.

os_run_priority

int

예약되어 있습니다.

output_file_name

nvarchar(200)

명령 출력을 기록할 파일입니다. Transact-SQL, CmdExecPowerShell 단계에만 적용됩니다.

last_run_outcome

int

단계가 마지막으로 실행되었을 때의 결과입니다.

0 = 실패

1 = 성공

2 = 다시 시도

3 = 취소됨

5 = 알 수 없음

last_run_duration

int

단계를 마지막으로 실행했을 때의 기간(초)입니다.

last_run_retries

int

단계를 마지막으로 실행했을 때 명령을 재시도할 횟수입니다.

last_run_date

int

단계가 마지막으로 실행을 시작했을 때의 날짜입니다.

last_run_time

int

단계가 마지막으로 실행을 시작했을 때의 시간입니다.

proxy_id

int

작업 단계에 대한 프록시입니다.

주의

sp_help_jobstepmsdb 데이터베이스에 있습니다.

사용 권한

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

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

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

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

1. 특정 작업의 모든 단계에 관한 정보 반환

다음 예에서는 Weekly Sales Data Backup이라는 작업의 모든 작업 단계를 반환합니다.

USE msdb ;
GO

EXEC dbo.sp_help_jobstep
    @job_name = N'Weekly Sales Data Backup' ;
GO

2. 특정 작업 단계에 관한 정보 반환

다음 예에서는 Weekly Sales Data Backup이라는 작업의 첫 번째 작업 단계에 대한 정보를 반환합니다.

USE msdb ;
GO

EXEC dbo.sp_help_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1 ;
GO