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 на подписчике.
Результирующие наборы
Имя столбца |
Тип данных |
Описание |
|---|---|---|
Session_id |
int |
Идентификатор сеанса для задания агента. |
Status |
int |
Состояние запуска агента: 1 = запущено. 2 = успешно выполнено. 3 = в процессе выполнения. 4 = бездействие. 5 = повтор. 6 = ошибка. |
StartTime |
datetime |
Время начала сеанса для задания агента. |
EndTime |
datetime |
Время завершения сеанса для задания агента. |
Duration |
int |
Совокупная продолжительность сеанса выполнения задания, в секундах. |
UploadedCommands |
int |
Количество команд, переданных за время сеанса работы агента. |
DownloadedCommands |
int |
Количество команд, принятых за время сеанса работы агента. |
ErrorMessages |
int |
Количество сообщений об ошибках, которые были сформированы во время сеанса работы агента. |
ErrorID |
int |
Идентификатор возникшей ошибки. |
PercentageDone |
decimal |
Приближенный процент общих изменений, которые уже были переданы в активном сеансе. |
TimeRemaining |
int |
Приблизительное число секунд, оставшееся до завершения активного сеанса. |
CurrentPhase |
int |
Текущая фаза активного сеанса, которая может принимать одно из следующих значений: 1 = выгрузка. 2 = загрузка. |
LastMessage |
nvarchar(500) |
Последнее сообщение, которое было записано в журнал агентом слияния во время сеанса. |
Значения кодов возврата
0 (успешное завершение) или 1 (неуспешное завершение)
Замечания
Процедура sp_replmonitorhelpmergesession используется для наблюдения репликации слиянием.
При выполнении на подписчике процедура sp_replmonitorhelpmergesession возвращает только сведения о последних пяти сеансах агента слияния.
Разрешения
Только элементы предопределенных ролей базы данных db_owner или replmonitor в базе данных распространителя на распространителе или в базе данных подписки на подписчике могут выполнять процедуру sp_replmonitorhelpmergesession.