sp_help_jobserver(Transact-SQL)
주어진 작업의 서버에 관한 정보를 반환합니다.
구문
sp_help_jobserver
{ [ @job_id = ] job_id
| [ @job_name = ] 'job_name' }
[ , [ @show_last_run_details = ] show_last_run_details ]
인수
[ @job_id= ] job_id
정보를 반환할 작업의 ID입니다. job_id는 uniqueidentifier이며 기본값은 NULL입니다.[ @job_name= ] 'job_name'
정보를 반환할 작업의 이름입니다. job_name은 sysname이며 기본값은 NULL입니다.[!참고]
job_id 또는 job_name 중 하나를 지정해야 하며 둘 다를 지정할 수는 없습니다.
[ @show_last_run_details= ] show_last_run_details
마지막 실행 정보가 결과 집합의 일부인지 여부입니다. show_last_run_details는 tinyint이며 기본값은 0입니다. 0에는 마지막 실행 정보가 포함되지 않고 1에는 포함됩니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
열 이름 |
데이터 형식 |
설명 |
---|---|---|
server_id |
int |
대상 서버의 ID입니다. |
server_name |
nvarchar(30) |
대상 서버의 컴퓨터 이름입니다. |
enlist_date |
datetime |
대상 서버가 마스터 서버에 참여한 날짜입니다. |
last_poll_date |
datetime |
대상 서버가 마지막으로 마스터 서버를 폴링한 날짜입니다. |
show_last_run_details가 1로 설정된 상태에서 sp_help_jobserver를 실행하면 결과 집합에 다음과 같은 열이 추가됩니다.
열 이름 |
데이터 형식 |
설명 |
---|---|---|
last_run_date |
int |
해당 대상 서버에서 작업이 마지막으로 실행을 시작한 날짜입니다. |
last_run_time |
int |
해당 서버에서 작업이 마지막으로 실행을 시작한 시간입니다. |
last_run_duration |
int |
해당 대상 서버에서 작업이 마지막으로 실행된 기간(초)입니다. |
last_outcome_message |
nvarchar(1024) |
작업의 마지막 결과에 대해 설명합니다. |
last_run_outcome |
int |
해당 서버에서 작업이 마지막으로 실행되었을 때의 결과입니다. 0 = 실패 1 = 성공 3 = 취소됨 5 = 알 수 없음 |
사용 권한
기본적으로 sysadmin 고정 서버 역할의 멤버는 이 저장 프로시저를 실행할 수 있습니다. 다른 사용자는 msdb 데이터베이스의 다음 SQL Server 에이전트 고정 데이터베이스 역할 중 하나를 부여 받아야 합니다.
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
이러한 역할의 사용 권한에 대한 자세한 내용은 SQL Server 에이전트 고정 데이터베이스 역할을 참조하십시오.
SQLAgentUserRole의 멤버는 각자 소유한 작업의 정보만 볼 수 있습니다.
예
다음 예에서는 마지막 실행 정보를 포함하여 NightlyBackups 작업에 대한 정보를 반환합니다.
USE msdb ;
GO
EXEC dbo.sp_help_jobserver
@job_name = N'NightlyBackups',
@show_last_run_details = 1 ;
GO