PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает дополнительные сведения о сеансах агента слияния.
public:
System::Data::DataSet ^ EnumMergeAgentSessions2(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumMergeAgentSessions2 (string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumMergeAgentSessions2 : string * int * bool -> System.Data.DataSetPublic Function EnumMergeAgentSessions2 (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetПараметры
- agentName
- String
Значение типа String, указывающее имя задания агента слияния. Для получения этого значения можно использовать свойство SynchronizationAgentName объекта MergeSubscription.
- sessionDuration
- Int32
Значение типа Int32, указывающее число прошлых часов, которым ограничиваются результаты. Например, если задать значение 24, будут возвращены сведения о сеансах агента за последние 24 часа. Если задать значение -1, возвращаются сведения за последние 100 сеансов, а если задать значение 0, возвращаются сведения обо всех сеансах.
- returnOnlyErrorSessions
- Boolean
Значение типа Boolean, указывающее, возвращаются ли данные только для сеансов, в которых произошла ошибка, или для всех сеансов. Если задано значение true, возвращаются только сеансы с ошибками. Если задано значение false, возвращаются все сеансы.
Возвращаемое значение
Объект DataSet, содержащий следующие столбцы.
| Столбец | Тип данных | Описание |
|---|---|---|
| Session_id | Int32 | Идентификатор сеанса для задания агента. |
| Состояние | Int32 | Состояние запуска агента: 1 = выполнение начато; 2 = успешное выполнение; 3 = выполняется; 4 = бездействует; 5 = повтор; 6 = ошибка. |
| StartTime | DateTime | Время начала сеанса для задания агента. |
| EndTime | DateTime | Время завершения сеанса для задания агента. |
| Duration | Int32 | Общая продолжительность сеанса задания агента в секундах. |
| UploadedCommands | Int32 | Количество команд, переданных за время сеанса для задания агента. |
| DownloadedCommands | Int32 | Количество команд, принятых за время сеанса для задания агента. |
| ErrorMessages | Int32 | Количество сообщений об ошибках, которые были сформированы во время сеанса для задания агента. |
| ErrorID | Int32 | Идентификатор возникшей ошибки. |
| PercentageDone | Decimal | Приближенный процент общих изменений, которые уже были переданы в активном сеансе. |
| TimeRemaining | Int32 | Приблизительное число секунд, оставшееся до завершения активного сеанса. |
| CurrentPhase | Int32 | Текущая фаза активного сеанса, которая может принимать одно из следующих значений: 1 = передача 2 = загрузка. |
| LastMessage | String | Последнее сообщение, которое было записано в журнал агентом слияния во время сеанса. |
Комментарии
Перед вызовом PublisherMonitor этого метода необходимо зафиксировать все изменения свойств объекта, так как свойства этого объекта, возможно, потребуется загрузить, если они еще не были загружены.
Метод EnumMergeAgentSessions2 может вызываться только членами db_owner предопределенных ролей базы данных или replmonitor в базе данных распространителя.
Вызов EnumMergeAgentSessions2 эквивалентен выполнению sp_replmonitorhelpmergesession (Transact-SQL).