Share via

  • Статья

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

Идентификатор сеанса для задания агента.

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.