sp_replmonitorhelpmergesession (Transact-SQL)
Область применения: SQL Server Управляемый экземпляр SQL Azure
Возвращает сведения о прошедших сеансах работы агента слияния для данной репликации. Возвращается по одной строке на каждый сеанс, который соответствует критерию фильтрации. Эта хранимая процедура, которая используется для наблюдения за репликацией слиянием, выполняется на базе данных распространителя или на базе данных подписки на стороне подписчика.
Соглашения о синтаксисе Transact-SQL
Синтаксис
sp_replmonitorhelpmergesession
[ [ @agent_name = ] N'agent_name' ]
[ , [ @hours = ] hours ]
[ , [ @session_type = ] session_type ]
[ , [ @publisher = ] N'publisher' ]
[ , [ @publisher_db = ] N'publisher_db' ]
[ , [ @publication = ] N'publication' ]
[ ; ]
Аргументы
[ @agent_name = ] N'agent_name'
Имя агента. @agent_name — nvarchar(100), без значения по умолчанию.
[ @hours = ] часы
Диапазон времени( в часах), для которого возвращаются сведения о сеансе агента журнала. @hours является int и может быть одним из следующих диапазонов.
значение | Описание |
---|---|
< 0 |
Возвращает сведения о последних запусках агента, максимум до 100 раз. |
0 (по умолчанию) |
Возвращает сведения обо всех последних запусках агента. |
> 0 |
Возвращает сведения о запусках агента, которые произошли за последние часы в течение последних часов . |
[ @session_type = ] session_type
Фильтрует результирующий набор на основе результата завершения сеанса. @session_type является int и может быть одним из этих значений.
значение | Описание |
---|---|
1 (по умолчанию) |
Сеанс агента с успешным результатом или с требованием повторения. |
0 |
Сеанс агента с неудачным результатом. |
[ @publisher = ] N'publisher'
Имя издателя. @publisher — sysname с значением по умолчаниюNULL
. Этот параметр используется при выполнении sp_replmonitorhelpmergesession
на подписчике.
[ @publisher_db = ] N'publisher_db'
Имя базы данных публикации. @publisher_db имеет имя sysname с значением по умолчаниюNULL
. Этот параметр используется при выполнении sp_replmonitorhelpmergesession
на подписчике.
[ @publication = ] N'publication'
Имя публикации. @publication — sysname с значением по умолчаниюNULL
. Этот параметр используется при выполнении sp_replmonitorhelpmergesession
на подписчике.
Результирующий набор
Имя столбца | Тип данных | Description |
---|---|---|
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 |
десятичное | Приближенный процент общих изменений, которые уже были переданы в активном сеансе. |
TimeRemaining |
int | Приблизительное число секунд, оставшееся до завершения активного сеанса. |
CurrentPhase |
int | Текущий этап активного сеанса и может быть одним из следующих.1 = Отправка2 = скачать |
LastMessage |
nvarchar(500) | Последнее сообщение, зарегистрированное агент слияния во время сеанса. |
Значения кода возврата
0
(успешно) или 1
(сбой).
Замечания
sp_replmonitorhelpmergesession
используется для мониторинга репликации слиянием.
При выполнении на подписчике sp_replmonitorhelpmergesession
возвращается только информация о последних пяти сеансах агент слияния.
Разрешения
Может выполняться sp_replmonitorhelpmergesession
только члены предопределенной роли базы данных db_owner или replmonitor в базе данных распространителя или в базе данных подписки на подписчике.