sp_helppullsubscription (Transact-SQL)
显示订阅服务器上的一个或多个订阅的有关信息。 此存储过程在订阅服务器的订阅数据库中执行。
语法
sp_helppullsubscription
[ [ @publisher = ] N'publisher' ]
[ , [ @publisher_db = ] N'publisher_db' ]
[ , [ @publication = ] N'publication' ]
[ , [ @show_push = ] N'show_push' ]
[ ; ]
参数
[ @publisher = ] N'publisher'
远程服务器的名称。 @publisher 是 sysname，默认值 %为 ，它将返回所有发布服务器的信息。
[ @publisher_db = ] N'publisher_db'
发布服务器数据库的名称。 @publisher_db为 sysname，默认值%为 ，返回所有发布服务器数据库。
[ @publication = ] N'publication'
发布的名称。 @publication为 sysname，默认值%返回所有发布。 如果此参数等于 ALL，则仅返回具有 independent_agent = 0 的拉取订阅。
[ @show_push = ] N'show_push'
指定是否返回所有推送订阅。 @show_push为 nvarchar（5），默认值false不返回推送订阅。
结果集
| 列名称 | 数据类型 | 描述 |
|---|---|---|
publisher |
sysname | 发布服务器的名称。 |
publisher database |
sysname | 发布服务器数据库名。 |
publication |
sysname | 发布的名称。 |
independent_agent |
bit | 指示此出版物是否有独立分发代理。 |
subscription type |
int | 发布的订阅类型。 |
distribution agent |
nvarchar(100) | 处理订阅的分发代理。 |
publication description |
nvarchar(255) | 对发布的说明。 |
last updating time |
date | 订阅信息上次更新的时间。 此值是 ISO 日期 （114） + ODBC 时间 （121） 的 Unicode 字符串。 格式是yyyyMMdd HH:mm:ss.nnnyyyy年份、MM月dd、日、HH小时、 mm ss分钟、秒和nnn毫秒。 |
subscription name |
varchar（386） | 订阅的名称。 |
last transaction timestamp |
varbinary(16) | 上一个复制的事务的时间戳。 |
update mode |
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 表中定义为远程服务器或链接服务器。 |
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:mm:ss.nnnyyyy年份、MM月dd、日、HH小时、 mm ss分钟、秒和nnn毫秒。 |
job_login |
nvarchar(512) | 分发代理在哪个 Windows 帐户下运行，该帐户以格式域\用户名返回。 |
job_password |
sysname | 出于安全原因，始终返回值 ********** 。 |
返回代码值
0（成功）或 1（失败）。
注解
sp_helppullsubscription 用于快照复制和事务复制。
权限
只有 sysadmin 固定服务器角色的成员或db_owner固定数据库角色的成员才能执行sp_helppullsubscription。