다음을 통해 공유

sp_help_jobstep(Transact-SQL)

  • 아티클

적용 대상:SQL Server

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

Transact-SQL 구문 표기 규칙

구문

sp_help_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @step_id = ] step_id ]
    [ , [ @step_name = ] N'step_name' ]
    [ , [ @suffix = ] suffix ]
[ ; ]

인수

[ @job_id = ] 'job_id'

작업 정보를 반환할 작업 ID입니다. @job_id 기본값NULL인 uniqueidentifier입니다.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @job_name = ] N'job_name'

작업의 이름입니다. @job_name sysname이며 기본값은 .입니다NULL.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @step_id = ] step_id

작업 단계의 ID입니다. 지정하지 않은 경우 작업의 모든 단계가 포함됩니다. @step_id 기본값NULL인 int입니다.

[ @step_name = ] N'step_name'

작업 단계의 이름입니다. @step_name 기본값NULL인 sysname입니다.

[ @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 이 값이4면 on_fail_action 실행할 다음 단계를 나타냅니다.
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 .

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

다른 사용자에게는 데이터베이스에서 다음 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

관련 콘텐츠