PublisherMonitor.EnumMergeAgentSessions(String, Int32, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает информацию о сеансах агента слияния.
public:
System::Data::DataSet ^ EnumMergeAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumMergeAgentSessions (string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumMergeAgentSessions : string * int * bool -> System.Data.DataSetPublic Function EnumMergeAgentSessions (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, содержащий следующие столбцы.
| Столбец | Тип данных | Описание |
|---|---|---|
| runstatus | Int32 | Состояние выполнения: 1 = выполнение начато; 2 = успешное выполнение; 3 = выполняется; 4 = бездействует; 5 = повтор; 6 = ошибка. |
| start_time | String | Дата и время последнего выполнения агента. |
| time | String | Дата и время завершения сеанса. |
| comments | String | Текст сообщения, зарегистрированный агентом. |
| длительность | Int32 | Истекшее время сеанса, в секундах. |
| delivery_rate | Single | Среднее число доставленных команд в секунду. |
| download_inserts | Int32 | Количество изменений, примененных на подписчике. |
| download_updates | Int32 | Количество обновлений, примененных на подписчике. |
| download_deletes | Int32 | Количество объектов, удаленных с подписчика. |
| download_conflicts | Int32 | Количество неполадок, возникших во время применения изменений на подписчике. |
| upload_inserts | Int32 | Количество изменений, примененных на издателе. |
| upload_updates | Int32 | Количество обновлений, примененных на издателе. |
| upload_deletes | Int32 | Количество объектов, удаленных с издателя. |
| upload_conflicts | Int32 | Количество неполадок, возникших во время применения изменений на издателе. |
| action_count | Int32 | Число сообщений журнала агента, записанных в ходе сеанса. |
| error_id | Int32 | Идентификатор ошибки в системной таблице [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) Метод EnumErrorRecords(Int32) позволяет возвращать подробные сведения об ошибке. |
Комментарии
Перед вызовом PublisherMonitor этого метода необходимо зафиксировать любые изменения свойств объекта, так как свойства этого объекта, возможно, потребуется загрузить, если они еще не загружены.
Метод EnumMergeAgentSessions может вызываться только членами db_owner или replmonitor предопределенных ролей базы данных в базе данных распространителя.