Transact-SQL 参考

sp_helpsubscription

列出与特定的发布、项目、订阅服务器或订阅集关联的订阅信息。此存储过程在发布服务器的发布数据库上执行。

语法

sp_helpsubscription [ [ @publication = ] 'publication' ]
    [ , [ @article = ] 'article' ]
    [ , [ @subscriber = ] 'subscriber' ]
    [ , [ @destination_db = ] 'destination_db' ]
    [ , [ @found =] found OUTPUT ]

参数

[@publication =] 'publication'

是关联的发布名。publication 的数据类型为 sysname,默认值为 %,表示返回该服务器的所有订阅信息。

[@article =] 'article'

是项目名。article 的数据类型为 sysname,默认值为 %,表示返回选定发布和订阅服务器的所有订阅信息。如果为 all,则表示只为发布上的完整订阅返回一项。

[@subscriber =] 'subscriber'

是获得其订阅信息的订阅服务器名称。subscriber 的数据类型为 sysname,默认值为 %,表示为选定的发布和项目返回所有订阅信息。

[@destination_db = ] 'destination_db'

是目的数据库名。destination_db 的数据类型为 sysname,默认值为 %。

[@found =] 'found' OUTPUT

是表示返回行的标记。found 的数据类型为 int,而且是 OUTPUT 参数,默认值为 23456。1 表示已找到发布。0 表示未找到发布。

结果集
列名 数据类型 描述
subscriber sysname 订阅服务器名。
publication sysname 发布名。
article sysname 项目名。
destination database sysname 用于存放复制数据的目的数据库的名称。
subscription status tinyint 订阅状态:

0 = 非活动
1 = 已订阅
2 = 活动

synchronization type tinyint 订阅同步类型:

1 = 自动
2 = 无

subscription type int 订阅的类型:

0 = 强制
1 = 请求
2 = 匿名

full subscription bit 表示订阅是否针对发布中的所有项目:

0 = 否
1 = 是

subscription name nvarchar(255) 订阅名。
update mode int 0 = 只读
1 = 即时更新订阅
distribution job id binary(16) 分发代理程序的作业 ID。
loopback_detection bit 0 = 否
1 = 是
offload_enabled bit 指定复制代理程序的卸载执行是否已设置为在订阅服务器上运行。如果为 0,则代理程序在发布服务器上运行。如果为 1,则代理程序在订阅服务器上运行。
offload_server sysname 为远程代理程序激活启用的服务器名称。如果为 NULL,则使用在 MSDistribution_agents 表中列出的当前 offload_server。
dts_package_name sysname 指定 DTS 包的名称。
dts_package_location int 如果将一个包指派给订阅,则为此 DTS 包的位置。如果有一个包,则数值 0 指定此包位于分发服务器上。而数值 1 指定位于订阅服务器上。

注释

sp_helpsubscription 用于快照复制、事务复制和合并复制。

权限

执行权限默认授予 public 角色。但是,sysadmin 固定服务器角色或 db_owner 固定数据库角色可以查看所有订阅,而其他用户得到的结果集仅列出了他们各自的订阅。

请参见

sp_addsubscription

sp_changesubstatus

sp_dropsubscription

系统存储过程