PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
返回有关合并代理会话的附加信息。
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_id | Int32 | 代理作业会话的 ID。 |
状态 | Int32 | 代理运行状态: 1 = 开始 2 = 成功 3 = 正在进行 4 = 空闲 5 = 重试 6 = 失败 |
StartTime | DateTime | 代理作业会话开始的时间。 |
EndTime | DateTime | 代理作业会话完成的时间。 |
持续时间 | Int32 | 代理作业会话的累计持续时间,以秒为单位。 |
UploadedCommands | Int32 | 在代理作业会话过程中上载的命令的数目。 |
DownloadedCommands | Int32 | 在代理作业会话过程中下载的命令的数目。 |
ErrorMessages | Int32 | 在代理作业会话过程中生成的错误消息的数目。 |
ErrorID | Int32 | 发生的错误的 ID。 |
PercentageDone | Decimal | 在活动会话中已交付的总更改的估计百分比。 |
TimeRemaining | Int32 | 估计的活动会话所剩秒数。 |
CurrentPhase | Int32 | 活动会话的当前阶段,可以是以下内容之一: 1 = 上载 2 = 下载 |
LastMessage | String | 合并代理在会话过程中记录的最后一个消息。 |
注解
应在调用此方法之前将 PublisherMonitor 任何属性更改提交到对象,因为如果尚未加载此对象的属性,则可能需要加载这些属性。
方法EnumMergeAgentSessions2只能由分发数据库上的 或 replmonitor
固定数据库角色的成员db_owner
调用。
调用 EnumMergeAgentSessions2 等效于执行 transact-SQL) sp_replmonitorhelpmergesession (。