sp_help_jobstep(Transact-SQL)
적용 대상:SQL Server
SQL Server 에이전트 서비스에서 자동화된 작업을 수행하는 데 사용하는 작업의 단계에 대한 정보를 반환합니다.
구문
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 기본값이 NULL인 uniqueidentifier입니다.
[ @job_name = ] 'job_name'
작업의 이름입니다. job_name 기본 NULL이 있는 sysname입니다.
참고 항목
job_id 또는 job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.
[ @step_id = ] step_id
작업 단계의 ID 번호입니다. 지정하지 않은 경우 작업의 모든 단계가 포함됩니다. step_id 기본값이 NULL인 int입니다.
[ @step_name = ] 'step_name'
작업의 단계 이름입니다. step_name sysname이며 기본값은 NULL입니다.
[ @suffix = ] suffix
출력의 플래그 열에 텍스트 설명이 추가되는지 여부를 나타내는 플래그 입니다. 접미사는비트이며 기본값은 0입니다. 접미사가 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 | 단계가 마지막으로 실행되었을 때의 시간(hhmmss)입니다. |
last_run_retries | int | 단계가 마지막으로 실행되었을 때 명령을 다시 시도한 횟수입니다. |
last_run_date | int | 단계가 마지막으로 실행을 시작했을 때의 날짜입니다. |
last_run_time | int | 단계가 마지막으로 실행을 시작한 시간입니다. |
proxy_id | int | 작업 단계의 프록시입니다. |
설명
sp_help_jobstep msdb 데이터베이스에 있습니다.
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 SQL Server msdb 데이터베이스의 다음 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하세요.
SQLAgentUserRole의 멤버는 자신이 소유한 작업에 대한 작업 단계만 볼 수 있습니다.
예
A. 특정 작업의 모든 단계에 대한 정보 반환
다음 예제에서는 명명 Weekly Sales Data Backup
된 작업에 대한 모든 작업 단계를 반환합니다.
USE msdb ;
GO
EXEC dbo.sp_help_jobstep
@job_name = N'Weekly Sales Data Backup' ;
GO
B. 특정 작업 단계에 대한 정보 반환
다음 예제에서는 명명 Weekly Sales Data Backup
된 작업의 첫 번째 작업 단계에 대한 정보를 반환합니다.
USE msdb ;
GO
EXEC dbo.sp_help_jobstep
@job_name = N'Weekly Sales Data Backup',
@step_id = 1 ;
GO
참고 항목
sp_add_jobstep(Transact-SQL)
sp_delete_jobstep(Transact-SQL)
sp_help_job(Transact-SQL)
sp_update_jobstep(Transact-SQL)
시스템 저장 프로시저(Transact-SQL)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기