sp_replmonitorhelpmergesession (Transact-SQL)

Статья
12/15/2008

Возвращает сведения о прошедших сеансах работы агента слияния для данной репликации. Возвращается по одной строке на каждый сеанс, который соответствует критерию фильтрации. Эта хранимая процедура, которая используется для наблюдения за репликацией слиянием, выполняется на базе данных распространителя или на базе данных подписки на стороне подписчика.

Значок ссылки на раздел Синтаксические обозначения в 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 на подписчике.

Значения кодов возврата

0 (успешное завершение) или 1 (неуспешное завершение)

Результирующие наборы

Имя столбца	Тип данных	Описание
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)	Последнее сообщение, которое было записано в журнал агентом слияния во время сеанса.

Замечания

Процедура sp_replmonitorhelpmergesession используется для наблюдения репликации слиянием.

При выполнении на подписчике процедура sp_replmonitorhelpmergesession возвращает только сведения о последних пяти сеансах агента слияния.

Разрешения

Только элементы фиксированных ролей базы данных db_owner или replmonitor в базе данных распространителя на распространителе или в базе данных подписки на подписчике могут выполнять процедуру sp_replmonitorhelpmergesession.

См. также

Другие ресурсы

How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)

Справка и поддержка

Получение помощи по SQL Server 2005

Поделиться через