sp_replmonitorhelpmergesession (Transact-SQL)
返回给定复制合并代理过去会话的信息，并且针对每个符合筛选条件的会话返回一行。此用于监视合并复制的存储过程在分发服务器的分发数据库上执行，或在订阅服务器的订阅数据库上执行。
.gif "主题链接图标")
语法
sp_replmonitorhelpmergesession [ [ @agent_name = ] 'agent_name' ]
[ , [ @hours = ] hours ]
[ , [ @session_type = ] session_type ]
[ , [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
参数
- [ @agent_name = ] 'agent_name'
代理的名称。agent_name 的数据类型为 nvarchar(100)，无默认值。
[ @hours = ] hours
以小时为单位的时间范围，将返回该范围内的历史代理会话信息。hours 的数据类型为 int，可以是下列范围之一。Value 说明 < 0
返回代理过去运行的信息，最多返回 100 条运行信息。
0（默认值）
返回代理过去运行的所有信息。
> 0
返回过去 hours 小时内代理运行的信息。
[ @session_type = ] session_type
基于会话最终结果筛选结果集。session_type 的数据类型为 int，可以是下列值之一。Value 说明 1（默认值）
具有重试或成功结果的代理会话。
0
具有失败结果的代理会话。
- [ @publisher= ] 'publisher'
发布服务器的名称。publisher 的数据类型为 sysname，默认值为 NULL。在订阅服务器上执行 sp_replmonitorhelpmergesession 时使用此参数。
- [ @publisher_db= ] 'publisher_db'
发布数据库的名称。publisher_db 的数据类型为 sysname，默认值为 NULL。在订阅服务器上执行 sp_replmonitorhelpmergesession 时使用此参数。
- [ @publication= ] 'publication'
发布的名称。publication 的数据类型为 sysname，默认值为 NULL。在订阅服务器上执行 sp_replmonitorhelpmergesession 时使用此参数。
返回代码值
0（成功）或 1（失败）
结果集
| 列名 | 数据类型 | 说明 |
|---|---|---|
Session_id |
int |
代理作业会话的 ID。 |
Status |
int |
代理运行状态： 1 = 开始 2 = 成功 3= 正在进行 4 = 空闲 5 = 重试 6 = 失败 |
StartTime |
datetime |
代理作业会话开始的时间。 |
EndTime |
datetime |
代理作业会话完成的时间。 |
Duration |
int |
此作业会话的累计时间（以秒为单位）。 |
UploadedCommands |
int |
在代理会话过程中上载的命令的数目。 |
DownloadedCommands |
int |
在代理会话过程中下载的命令的数目。 |
ErrorMessages |
int |
在代理会话过程中生成的错误消息的数目。 |
ErrorID |
int |
发生的错误的 ID。 |
PercentageDone |
decimal |
已经在活动会话中传递的全部更改的估计百分比。 |
TimeRemaining |
int |
估计的活动会话所剩秒数。 |
CurrentPhase |
int |
活动会话的当前阶段，可以是以下内容之一。 1 = 上载 2 = 下载 |
LastMessage |
nvarchar(500) |
合并代理在会话过程中记录的最后一个消息。 |
备注
sp_replmonitorhelpmergesession 用于监视合并复制。
在订阅服务器上执行时，sp_replmonitorhelpmergesession 只返回最后五个合并代理会话的信息。
权限
只有分发服务器的分发数据库或订阅服务器的订阅数据库上的 db_owner 或 replmonitor 固定数据库角色成员才能执行 sp_replmonitorhelpmergesession。
请参阅
其他资源
How to: Programmatically Monitor Replication (Replication Transact-SQL Programming)