sp_replmonitorhelpsubscription (Transact-SQL)
返回发布服务器上属于一个或多个发布的订阅的当前状态信息,并为每个返回的订阅返回一行。 在分发服务器的分发数据库上执行此存储过程,用于监视复制。
语法
sp_replmonitorhelpsubscription [ @publisher = ] 'publisher'
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
[ , [ @publication_type = ] publication_type ]
[ , [ @mode = ] mode ]
[ , [ @topnum = ] topnum ]
[ , [ @exclude_anonymous = ] exclude_anonymous ]
[ , [ @refreshpolicy = ] refreshpolicy ]
参数
[ @publisher = ] 'publisher'
正在监视其状态的发布服务器的名称。 publisher 为 sysname,默认值为 NULL。 如果 为 null,则会为使用分发服务器的所有发布服务器返回信息。
[ @publisher_db = ] 'publisher_db'
已发布数据库的名称。 publisher_db为 sysname,默认值为 NULL。 如果为 NULL,则返回发布服务器上所有已发布数据库的信息。
[ @publication = ] 'publication'
正在监视的发布的名称。 publication 为 sysname,默认值为 NULL。
[ @publication_type = ] publication_type
如果发布类型。 publication_type为 int,可以是这些值之一。
值 | 说明 |
---|---|
0 | 事务发布。 |
1 | 快照发布。 |
2 | 合并发布。 |
NULL(默认值) | 由复制来确定发布类型。 |
[ @mode = ] mode
返回订阅监视信息时要使用的筛选模式。 模式 为 int,可以是以下值之一。
值 | 说明 |
---|---|
0 (默认值) | 返回所有订阅。 |
1 | 只返回带错误的订阅。 |
2 | 只返回已生成在达到阈值度量指标时发出的警告的订阅。 |
3 | 只返回带错误或已生成在达到阈值度量指标时发出的警告的订阅。 |
4 | 返回表现最差的前 25 个订阅。 |
5 | 返回执行情况最差的 50 个订阅。 |
6 | 只返回当前同步的订阅。 |
7 | 只返回当前不同步的订阅。 |
[ @topnum = ] topnum
将结果集限制为返回的数据顶部的指定订阅数。 topnum 为 int,无默认值。
[ @exclude_anonymous = ] exclude_anonymous
是否从结果集中排除了匿名拉取订阅。 exclude_anonymous为位,默认值为 0;值为 1 表示排除匿名订阅,值为 0 表示包含这些订阅。
[ @refreshpolicy = ] refreshpolicy
仅供内部使用。
结果集
列名称 | 数据类型 | 说明 |
---|---|---|
status | int | 检查与该发布关联的所有复制代理的状态,并返回按以下顺序找到的最高级状态: 6 = 失败 5 = 重试 2 = 已停止 4 = 空闲 3 = 正在进行 1 = 已启动 |
警告 | int | 由属于该发布的订阅所生成的最大阈值警告,可以是下列一个或多个值进行逻辑或运算的结果。 1 = 过期 - 在保留期阈值内尚未同步事务发布的订阅。 2 = 延迟 - 将数据从事务发布服务器复制到订阅服务器所花费的时间超过阈值(以秒为单位)。 4 = mergeexpiration - 合并发布的订阅未在保留期阈值内同步。 8 = mergefastrunduration - 完成合并订阅同步所需的时间超过了通过快速网络连接的阈值(以秒为单位)。 16 = mergeslowrunduration - 完成合并订阅同步所需的时间超过阈值(以秒为单位)超过慢速或拨号网络连接。 32 = mergefastrunspeed - 合并订阅同步期间行的传递率未能通过快速网络连接保持阈值速率(以每秒行为单位)。 64 = mergeslowrunspeed - 合并订阅同步期间行的传递率未能通过慢速或拨号网络连接保持阈值速率(以每秒行为单位)。 |
subscriber | sysname | 订阅服务器的名称。 |
subscriber_db | sysname | 用于订阅的数据库的名称。 |
publisher_db | sysname | 发布数据库的名称。 |
出版 | sysname | 发布的名称。 |
publication_type | int | 发布的类型,可以是下列值之一: 0 = 事务发布 1 = 快照发布 2 = 合并发布 |
subtype | int | 订阅类型,可以是下列值之一: 0 = 推送 1 = 拉取 2 = 匿名 |
latency | int | 在事务发布中,由日志读取器代理或分发代理传播的数据更改的最长滞后时间(以秒为单位)。 |
latencythreshold | int | 事务发布的最长滞后时间,高于此时间即产生警告。 |
agentnotrunning | int | 代理未运行的时间长度,以小时为单位。 |
agentnotrunningthreshold | int | 产生警告前代理未运行的时间长度,以小时为单位。 |
timetoexpiration | int | 订阅未同步时订阅过期前的时间长度,以小时为单位。 |
expirationthreshold | int | 订阅过期导致警告产生前的时间,以小时为单位。 |
last_distsync | datetime | 分发代理上次运行的日期时间。 |
distribution_agentname | sysname | 事务发布订阅的分发代理作业的名称。 |
mergeagentname | sysname | 合并发布订阅的合并代理作业的名称。 |
mergesubscriptionfriendlyname | sysname | 为订阅指定的友好名称。 |
mergeagentlocation | sysname | 运行合并代理的服务器的名称。 |
mergeconnectiontype | int | 将订阅同步到合并发布时使用的连接,可以是下列值之一: 1 = 局域网 (LAN) 2 = 拨号网络连接 3 = Web 同步。 |
mergePerformance | int | 订阅的上次同步相对于其所有同步而言的性能,用上次同步的传递速率除以之前所有传递速率的平均值。 |
mergerunspeed | float | 订阅的上次同步的传递速率。 |
合并 | int | 完成订阅的上次同步的时间长度。 |
monitorranking | int | 用于对结果集中的订阅进行排序的排名值,可以是下列值之一: 对于事务发布: 60 = 错误 56 = 警告:性能严重 52 = 警告:即将过期或已过期 50 = 警告:订阅未初始化 40 = 重试失败命令 30 = 未运行(成功) 20 = 正在运行(正在启动、正在运行或空闲) 对于合并发布: 60 = 错误 56 = 警告:性能严重 54 = 警告:长时间运行的合并 52 = 警告:即将过期 50 = 警告:订阅未初始化 40 = 重试失败命令 30 = 正在运行(正在启动、运行或空闲) 20 = 未运行(成功) |
distributionagentjobid | binary(16) | 事务发布订阅的分发代理作业的 ID。 |
mergeagentjobid | binary(16) | 合并发布订阅的合并代理作业的 ID。 |
distributionagentid | int | 订阅的分发代理作业的 ID。 |
distributionagentprofileid | int | 分发代理使用的代理配置文件的 ID。 |
mergeagentid | int | 订阅的合并代理作业的 ID。 |
mergeagentprofileid | int | 合并代理使用的代理配置文件的 ID。 |
返回代码值
0 (成功) 或 1 (失败)
注解
sp_replmonitorhelpsubscription用于所有类型的复制。
sp_replmonitorhelpsubscription根据订阅状态的严重性对结果集进行排序,该状态由监视值确定。 例如,处于错误状态的所有订阅的各行排在处于警告状态的订阅的各行之上。
权限
只有分发数据库上的 db_owner 或 replmonitor 固定数据库角色的成员才能执行 sp_replmonitorhelpsubscription。