sp_help_jobserver(Transact-SQL)

  • 아티클

주어진 작업의 서버에 관한 정보를 반환합니다.

항목 링크 아이콘 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

참고 항목

참조

sp_add_jobserver(Transact-SQL)

sp_delete_jobserver(Transact-SQL)

시스템 저장 프로시저(Transact-SQL)