PublisherMonitor.EnumDistributionAgentSessions(String, Int32, Boolean) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает информацию о сессиях агент распространения.
public:
System::Data::DataSet ^ EnumDistributionAgentSessions(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);public System.Data.DataSet EnumDistributionAgentSessions(string agentName, int sessionDuration, bool returnOnlyErrorSessions);member this.EnumDistributionAgentSessions : string * int * bool -> System.Data.DataSetPublic Function EnumDistributionAgentSessions (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSetПараметры
- agentName
- String
String Значение, указывающее имя работы агент распространения. Вы можете использовать SynchronizationAgentName свойство TransSubscription объекта для получения этого значения.
- 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 | Дата и время регистрации сессии. |
| Комментарии | String | Текст сообщения, зарегистрированный агентом. |
| Длительность | Int32 | Прошедшее время сессии — за секунды. |
| delivery_rate | Single | Среднее количество команд, передаваемых в секунду. |
| delivery_latency | Int32 | Задержка в миллисекундах между входом транзакции в базу данных распределения и применением абонента. |
| (Без названия колонки) | Неприменимо | Только для внутреннего применения. |
| delivered_transactions | Int32 | Общее количество транзакций, выполненных за сессию. |
| delivered_commands | Int32 | Общее количество команд, отданных за сессию. |
| average_commands | Int32 | Среднее количество команд на одну транзакцию, доставленную в сессии. |
| action_count | Int32 | Количество сообщений журнала агентов, записанных в сессии. |
| error_id | Int32 | ID ошибки в таблице [MSrepl_errors (Transact-SQL)](http://msdn.microsoft.com/library/c6e023c1-2c32-4269-8d76-e442ea309e4b) Используйте EnumErrorRecords(Int32) метод для получения подробной информации об ошибке. |
Комментарии
Перед вызовом этого метода следует фиксировать любые изменения PublisherMonitor свойств объекта, так как свойства объекта могут потребоваться загрузки, если они ещё не были загружены.
EnumDistributionAgentSessions Метод может вызываться только членами db_owner или replmonitor фиксированными ролями базы данных в базе данных распределения.