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.DataSet
Public 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_idInt32 代理作业会话的 ID。
状态Int32 代理运行状态:

1 = 开始

2 = 成功

3 = 正在进行

4 = 空闲

5 = 重试

6 = 失败

StartTimeDateTime 代理作业会话开始的时间。
EndTimeDateTime 代理作业会话完成的时间。
持续时间Int32 代理作业会话的累计持续时间,以秒为单位。
UploadedCommandsInt32 在代理作业会话过程中上载的命令的数目。
DownloadedCommandsInt32 在代理作业会话过程中下载的命令的数目。
ErrorMessagesInt32 在代理作业会话过程中生成的错误消息的数目。
ErrorIDInt32 发生的错误的 ID。
PercentageDoneDecimal 在活动会话中已交付的总更改的估计百分比。
TimeRemainingInt32 估计的活动会话所剩秒数。
CurrentPhaseInt32 活动会话的当前阶段,可以是以下内容之一:

1 = 上载

2 = 下载

LastMessageString 合并代理在会话过程中记录的最后一个消息。

注解

应在调用此方法之前将 PublisherMonitor 任何属性更改提交到对象,因为如果尚未加载此对象的属性,则可能需要加载这些属性。

方法EnumMergeAgentSessions2只能由分发数据库上的 或 replmonitor 固定数据库角色的成员db_owner调用。

调用 EnumMergeAgentSessions2 等效于执行 transact-SQL) sp_replmonitorhelpmergesession (

适用于

另请参阅