sp_helppullsubscription (Transact-SQL)
显示订阅服务器上的一个或多个订阅的有关信息。 此存储过程在订阅服务器的订阅数据库中执行。
.gif "主题链接图标")
语法
sp_helppullsubscription [ [ @publisher = ] 'publisher' ]
[ , [ @publisher_db = ] 'publisher_db' ]
[ , [ @publication = ] 'publication' ]
[ , [ @show_push = ] 'show_push' ]
参数
[ @publisher=] 'publisher'
远程服务器的名称。 publisher 的数据类型为 sysname，默认值为 %，表示返回所有发布服务器的信息。[ @publisher_db=] 'publisher_db'
发布服务器数据库的名称。 publisher_db 的数据类型为 sysname，默认值为 %，表示返回所有发布服务器数据库。[ @publication=] 'publication'
发布的名称。 publication 的数据类型为 sysname，默认值为 %，表示返回所有发布。 如果此参数等于 ALL，则只返回 independent_agent = 0 的请求订阅。[ @show_push=] 'show_push'
指示是否返回所有推送订阅。 show_push 的数据类型为 nvarchar(5)，默认值为 FALSE，表示不返回推送订阅。
结果集
列名 |
数据类型 |
说明 |
|---|---|---|
publisher |
sysname |
发布服务器的名称。 |
publisher database |
sysname |
发布服务器数据库的名称。 |
publication |
sysname |
发布的名称。 |
independent_agent |
bit |
指示该发布是否有独立的分发代理。 |
订阅类型 |
int |
发布的订阅类型。 |
distribution agent |
nvarchar(100) |
处理订阅的分发代理。 |
publication description |
nvarchar(255) |
对发布的说明。 |
last updating time |
date |
订阅信息上次更新的时间。 这是由 ISO 日期 (114) 和 ODBC 时间 (121) 组成的 UNICODE 字符串。 格式为 yyyymmdd hh:mi:sss.mmm，其中“yyyy”表示年，“mm”表示月，“dd”表示日，“hh”表示小时，“mi”表示分钟，“sss”表示秒，“mmm”表示毫秒。 |
订阅名称 |
varchar(386) |
订阅的名称。 |
last transaction timestamp |
varbinary(16) |
上一个复制的事务的时间戳。 |
更新模式 |
tinyint |
允许的更新类型。 |
distribution agent job_id |
int |
分发代理的作业 ID。 |
enabled_for_synmgr |
int |
指示是否可以通过 Microsoft 同步管理器同步订阅。 |
subscription guid |
binary(16) |
发布上订阅版本的全局标识符。 |
subid |
binary(16) |
匿名订阅的全局标识符。 |
immediate_sync |
bit |
表示是否在每次快照代理运行时创建或重新创建同步文件。 |
publisher login |
sysname |
在发布服务器上用于 SQL Server 身份验证的登录 ID。 |
publisher password |
nvarchar(524) |
在发布服务器上用于 SQL Server 身份验证的密码（加密）。 |
publisher security_mode |
int |
在发布服务器上实施的安全模式： 0 = SQL Server 身份验证 1 = Windows 身份验证 2 = 同步触发器使用静态 sysservers 项执行远程过程调用 (RPC)，并且必须在 sysservers 表中将 publisher 定义为远程服务器或链接服务器。 |
distributor |
sysname |
分发服务器的名称。 |
distributor_login |
sysname |
在分发服务器上用于 SQL Server 身份验证的登录 ID。 |
distributor_password |
nvarchar(524) |
在分发服务器上用于 SQL Server 身份验证的密码（加密）。 |
distributor_security_mode |
int |
在分发服务器上实施的安全模式： 0 = SQL Server 身份验证 1 = Windows 身份验证 |
ftp_address |
sysname |
仅为保持向后兼容。 |
ftp_port |
int |
仅为保持向后兼容。 |
ftp_login |
sysname |
仅为保持向后兼容。 |
ftp_password |
nvarchar(524) |
仅为保持向后兼容。 |
alt_snapshot_folder |
nvarchar(255) |
存储快照文件夹的位置（如果该位置是默认位置以外的位置）。 |
working_directory |
nvarchar(255) |
使用文件传输协议 (FTP) 传输快照文件（指定了该选项时）时将文件传输到的目录的完全限定路径。 |
use_ftp |
bit |
订阅通过 Internet 订阅发布，并配置 FTP 寻址属性。 如果为 0，则订阅不使用 FTP。 如果为 1，则订阅使用 FTP。 |
publication_type |
int |
指定发布的复制类型： 0 = 事务复制 1 = 快照复制 2 = 合并复制 |
dts_package_name |
sysname |
指定 Data Transformation Services (DTS) 包的名称。 |
dts_package_location |
int |
存储 DTS 包的位置： 0 = 分发服务器 1 = 订阅服务器 |
offload_agent |
bit |
指定是否可以远程激活代理。 如果为 0，则无法远程激活代理。 |
offload_server |
sysname |
指定用于远程激活的服务器所在的网络的名称。 |
last_sync_status |
int |
订阅状态： 0 = 所有作业都在等待启动 1 = 一个或多个作业正在启动 2 = 所有作业都已成功执行 3 = 至少有一个作业正在执行 4 = 所有作业都已安排好并处于空闲状态 5 = 在上次失败后至少有一个作业正在尝试执行 6 = 至少有一个作业不能成功执行 |
last_sync_summary |
sysname |
对上一次同步结果的说明。 |
last_sync_time |
datetime |
订阅信息上次更新的时间。 这是由 ISO 日期 (114) 和 ODBC 时间 (121) 组成的 UNICODE 字符串。 格式为 yyyymmdd hh:mi:sss.mmm，其中“yyyy”表示年，“mm”表示月，“dd”表示日，“hh”表示小时，“mi”表示分钟，“sss”表示秒，“mmm”表示毫秒。 |
job_login |
nvarchar(512) |
运行分发代理时所用的 Windows 帐户，以 domain\username 的格式返回。 |
job_password |
sysname |
出于安全原因，总是返回值“**********”。 |
返回代码值
0（成功）或 1（失败）
注释
sp_helppullsubscription 用于快照复制和事务复制。
权限
只有 sysadmin 固定服务器角色成员或 db_owner 固定数据库角色成员才能执行 sp_helppullsubscription。
请参阅
参考
sp_addpullsubscription (Transact-SQL)