sp_help_jobstep(Transact-SQL)
SQL Server 에이전트 서비스가 자동화된 작업을 수행하는 데 사용하는 작업의 단계에 대한 정보를 반환합니다.
.gif "항목 링크 아이콘")
구문
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, CmdExec 및 PowerShell 단계에만 적용됩니다. |
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_jobstep은 msdb 데이터베이스에 있습니다.
사용 권한
기본적으로 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