sp_replmonitorhelpmergesession(Transact-SQL)
지정된 복제 병합 에이전트의 이전 세션에 대한 정보를 필터링 조건에 일치하는 각 세션당 한 행씩 반환합니다. 병합 복제 모니터링에 사용되는 이 저장 프로시저는 배포 데이터베이스의 배포자 또는 구독 데이터베이스의 구독자에서 실행됩니다.
.gif "항목 링크 아이콘")
구문
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을 실행할 때 사용됩니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
| 열 이름 | 데이터 형식 | 설명 |
|---|---|---|
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) |
세션 중에 병합 에이전트에서 기록한 마지막 메시지입니다. |
주의
sp_replmonitorhelpmergesession은 병합 복제를 모니터링하는 데 사용합니다.
구독자에서 실행되는 경우 sp_replmonitorhelpmergesession은 마지막 5개의 병합 에이전트 세션에 대한 정보만 반환합니다.
사용 권한
배포자의 배포 데이터베이스 또는 구독자의 구독 데이터베이스에 대한 db_owner 또는 replmonitor 고정 데이터베이스 역할의 멤버만 sp_replmonitorhelpmergesession을 실행할 수 있습니다.
참고 항목
관련 자료
How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)