sp_helpsubscription (Transact-SQL)
列出与特定的发布、项目、订阅服务器或订阅集关联的订阅信息。此存储过程在发布服务器上对发布数据库执行。
.gif "主题链接图标")
语法
sp_helpsubscription [ [ @publication = ] 'publication' ]
[ , [ @article = ] 'article' ]
[ , [ @subscriber = ] 'subscriber' ]
[ , [ @destination_db = ] 'destination_db' ]
[ , [ @found=] found OUTPUT ]
[ , [ @publisher = ] 'publisher' ]
参数
- [ @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 指示未找到发布。
[ @publisher= ] 'publisher'
发布服务器的名称。publisher 的数据类型为 sysname，默认为当前服务器的名称。.gif "ms190493.note(zh-cn,SQL.90).gif")
注意：不应指定 publisher，除非它是 Oracle 发布服务器。
返回代码值
0（成功）或 1（失败）
结果集
列名
数据类型
说明
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
指定 Data Transformation Services (DTS) 包的名称。
dts_package_location
int
为订阅分配了一个 DTS 包时，此包的位置。如果有一个包，则值 0 指定此包位于 distributor。值 1 指定为 subscriber。
subscriber_security_mode
smallint
订阅服务器上的安全模式，其中 1 表示 Windows 身份验证，0 表示 SQL Server 身份验证。
subscriber_login
sysname
在订阅服务器上的登录名。
subscriber_password
永远不会返回实际的订阅服务器密码。结果被“******”字符串所掩盖。
job_login
sysname
分发代理运行时所用的 Windows 帐户的名称。
job_password
从不返回实际的作业密码。结果被“******”字符串所掩盖。
distrib_agent_name
nvarchar(100)
同步订阅的代理作业的名称。
subscriber_type
tinyint
订阅服务器的类型，可以是下列类型之一：
值
说明
0SQL Server 订阅服务器
1ODBC 数据源服务器
2Microsoft JET 数据库（不推荐使用）
3OLE DB 访问接口
subscriber_provider
sysname
非 SQL Server 数据源的 OLE DB 访问接口用于注册的唯一编程标识符 (PROGID)。
subscriber_datasource
nvarchar(4000)
OLE DB 访问接口识别的数据源的名称。
subscriber_providerstring
nvarchar(4000)
OLE DB 访问接口特定的连接字符串，用于标识数据源。
subscriber_location
nvarchar(4000)
OLE DB 访问接口所了解的数据库的位置
subscriber_catalog
sysname
在与 OLE DB 访问接口建立连接时要使用的目录。
备注
sp_helpsubscription 用于快照复制和事务复制。
权限
默认情况下，public 角色具有执行权限。只为用户返回他们创建的订阅的信息。全部订阅的信息返回给发布服务器上的 sysadmin 固定服务器角色成员或发布数据库上的 db_owner 固定数据库角色成员。
请参阅
参考
sp_addsubscription (Transact-SQL)
sp_changesubstatus (Transact-SQL)
sp_dropsubscription (Transact-SQL)
系统存储过程 (Transact-SQL)