sp_replmonitorhelpmergesession(Transact-SQL)

지정된 복제 병합 에이전트의 이전 세션에 대한 정보를 필터링 조건에 일치하는 각 세션당 한 행씩 반환합니다. 병합 복제 모니터링에 사용되는 이 저장 프로시저는 배포 데이터베이스의 배포자 또는 구독 데이터베이스의 구독자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

sp_replmonitorhelpmergesession [ [ @agent_name = ] 'agent_name' ]
    [ , [ @hours = ] hours ]
    [ , [ @session_type = ] session_type ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @publisher_db = ] 'publisher_db' ]
    [ , [ @publication = ] 'publication' ] 

인수

• [ @agent_name = ] 'agent_name'
  에이전트의 이름입니다. agent_name은 **nvarchar(100)**이며 기본값은 없습니다.

• [ @hours = ] hours
  기록 에이전트 세션 정보를 반환할 시간 범위(시간)입니다. hours는 int이며 다음 범위 중 하나일 수 있습니다.

  값	설명
  < 0	이전에 실행된 에이전트 세션에 대한 정보를 최대 100개까지 반환합니다.
  0(기본값)	이전에 실행된 모든 에이전트 세션에 대한 정보를 반환합니다.
  > 0	지난 hours 시간 동안 실행된 에이전트 세션에 대한 정보를 반환합니다.

• [ @session_type = ] session_type
  세션 종료 결과를 기준으로 결과 집합을 필터링합니다. session_type은 int이며 다음 값 중 하나일 수 있습니다.

  값	설명
  1(기본값)	다시 시도 또는 성공한 에이전트 세션입니다.
  0	실패한 에이전트 세션입니다.

• [ @publisher = ] 'publisher'
  게시자의 이름입니다. publisher는 sysname이며 기본값은 NULL입니다. 이 매개 변수는 구독자에서 sp_replmonitorhelpmergesession을 실행할 때 사용됩니다.

• [ @publisher_db = ] 'publisher_db'
  게시 데이터베이스의 이름입니다. publisher_db는 sysname이며 기본값은 NULL입니다. 이 매개 변수는 구독자에서 sp_replmonitorhelpmergesession을 실행할 때 사용됩니다.

• [ @publication= ] 'publication'
  게시 이름입니다. publication은 sysname이며 기본값은 NULL입니다. 이 매개 변수는 구독자에서 sp_replmonitorhelpmergesession을 실행할 때 사용됩니다.

결과 집합

열 이름	데이터 형식	설명
Session_id	int	에이전트 작업 세션의 ID입니다.
Status	int	에이전트 실행 상태입니다. 1 = 시작 2 = 성공 3 = 진행 중 4 = 유휴 상태 5 = 다시 시도 6 = 실패
StartTime	datetime	에이전트 작업 세션이 시작된 시간입니다.
EndTime	datetime	에이전트 작업 세션이 완료된 시간입니다.
Duration	int	해당 작업 세션에 소요된 총 시간(초)입니다.
UploadedCommands	int	에이전트 세션 중에 업로드된 명령 수입니다.
DownloadedCommands	int	에이전트 세션 중에 다운로드된 명령 수입니다.
ErrorMessages	int	에이전트 세션 중에 생성된 오류 메시지 수입니다.
ErrorID	int	발생한 오류의 ID입니다.
PercentageDone	decimal	활성 세션에서 이미 전달된 전체 변경 내용의 예상 비율(%)입니다.
TimeRemaining	int	활성 세션에서 남은 예상 시간(초)입니다.
CurrentPhase	int	활성 세션의 현재 단계이며 다음 중 하나일 수 있습니다. 1 = 업로드 2 = 다운로드
LastMessage	nvarchar(500)	세션 중에 병합 에이전트에서 기록한 마지막 메시지입니다.

반환 코드 값

0(성공) 또는 1(실패)

주의

sp_replmonitorhelpmergesession은 병합 복제를 모니터링하는 데 사용합니다.

구독자에서 실행되는 경우 sp_replmonitorhelpmergesession은 마지막 5개의 병합 에이전트 세션에 대한 정보만 반환합니다.

사용 권한

배포자의 배포 데이터베이스 또는 구독자의 구독 데이터베이스에 대한 db_owner 또는 replmonitor 고정 데이터베이스 역할의 멤버만 sp_replmonitorhelpmergesession을 실행할 수 있습니다.

참고 항목

태스크

방법: 프로그래밍 방식으로 복제 모니터링(복제 Transact-SQL 프로그래밍)