sp_helpmergepullsubscription (Transact-SQL)
适用范围：
SQL Server
返回有关订阅服务器中存在的请求订阅的信息。 此存储过程在订阅服务器的订阅数据库中执行。
语法
sp_helpmergepullsubscription
[ [ @publication = ] N'publication' ]
[ , [ @publisher = ] N'publisher' ]
[ , [ @publisher_db = ] N'publisher_db' ]
[ , [ @subscription_type = ] N'subscription_type' ]
[ ; ]
参数
[ @publication = ] N'publication'
发布的名称。 @publication为 sysname，默认值为 %. 如果@publication%，则返回有关当前数据库中所有合并发布和订阅的信息。
[ @publisher = ] N'publisher'
发布服务器的名称。 @publisher为 sysname，默认值为 %.
[ @publisher_db = ] N'publisher_db'
发布服务器数据库的名称。 @publisher_db为 sysname，默认值为 %.
[ @subscription_type = ] N'subscription_type'
指定是否显示请求订阅。 @subscription_type为 nvarchar（10），默认值为 pull. 有效值为 push、pull、both。
结果集
| 列名称 | 数据类型 | 描述 |
|---|---|---|
subscription_name |
nvarchar(1000) | 订阅的名称。 |
publication |
sysname | 发布的名称。 |
publisher |
sysname | 发布服务器的名称。 |
publisher_db |
sysname | 发布服务器数据库名。 |
subscriber |
sysname | 订阅服务器的名称。 |
subscriber_db |
sysname | 订阅数据库的名称。 |
status |
int | 订阅状态：0 = 非活动订阅1 = 活动订阅2 = 已删除的订阅3 = 分离订阅4 = 附加订阅5 = 订阅已标记为使用上传重新初始化6 = 附加订阅失败7 = 从备份还原的订阅 |
subscriber_type |
int | 订阅服务器的类型：1 = 全局2 = 本地3 = 匿名 |
subscription_type |
int | 订阅的类型：0 = 推送1 = 拉取2 = 匿名 |
priority |
float（8） | 订阅优先级。 该值必须小于 100.00。 |
sync_type |
tinyint | 订阅同步类型：1 = 自动2 = 不使用快照。 |
description |
nvarchar(255) | 对请求订阅的简短说明。 |
merge_jobid |
binary(16) | 合并代理的作业 ID。 |
enabled_for_syncmgr |
int | 指定是否可以通过Microsoft同步管理器同步订阅。 |
last_updated |
nvarchar（26） | 合并代理上次成功同步订阅的时间。 |
publisher_login |
sysname | 发布服务器登录名。 |
publisher_password |
sysname | 发布服务器密码。 |
publisher_security_mode |
int | 指定发布服务器的安全模式：0 = SQL Server 身份验证1 = Windows 身份验证 |
distributor |
sysname | 分发服务器的名称。 |
distributor_login |
sysname | 分发服务器登录名。 |
distributor_password |
sysname | 分发服务器密码。 |
distributor_security_mode |
int | 指定分发服务器的安全模式：0 = SQL Server 身份验证1 = Windows 身份验证 |
ftp_address |
sysname | 仅为向后兼容而提供。 分发服务器的文件传输协议 （FTP） 服务的网络地址。 |
ftp_port |
int | 仅为向后兼容而提供。 分发服务器的 FTP 服务的端口号。 |
ftp_login |
sysname | 仅为向后兼容而提供。 用于连接到 FTP 服务的用户名。 |
ftp_password |
sysname | 仅为向后兼容而提供。 用于连接到 FTP 服务的用户密码。 |
alt_snapshot_folder |
nvarchar(255) | 存储快照文件夹的位置（如果该位置是默认位置以外的位置）。 |
working_directory |
nvarchar(255) | 指定该选项时，使用 FTP 传输快照文件的目录的完全限定路径。 |
use_ftp |
bit | 订阅正通过 Internet 订阅发布，且已配置 FTP 寻址属性。 如果 0，订阅未使用 FTP。 如果 1为订阅，则使用 FTP。 |
offload_agent |
bit | 指定是否可以远程激活和运行代理。 如果 0无法远程激活代理。 |
offload_server |
sysname | 用于远程激活的服务器的名称。 |
use_interactive_resolver |
int | 返回在调节过程中是否使用交互式冲突解决程序。 如果未 0使用交互式解析程序。 |
subid |
uniqueidentifier | 订阅服务器的 ID。 |
dynamic_snapshot_location |
nvarchar(255) | 保存快照文件的文件夹路径。 |
last_sync_status |
int | 同步状态：1 = 正在启动2 = Succeeded3 = 正在进行中4 = 空闲5 = 在上一次失败后重试6 = 失败7 = 验证失败8 = 通过验证9 = 请求关闭 |
last_sync_summary |
sysname | 对上一次同步结果的说明。 |
use_web_sync |
bit | 指定是否可以通过 HTTPS 同步订阅，其中一个值 1 表示已启用此功能。 |
internet_url |
nvarchar(260) | 表示 Web 同步复制侦听器位置的 URL。 |
internet_login |
nvarchar(128) | 在使用基本身份验证连接到承载 Web 同步的 Web 服务器时，合并代理所使用的登录名。 |
internet_password |
nvarchar（524） | 在使用基本身份验证连接到承载 Web 同步的 Web 服务器时，合并代理所使用的登录密码。 |
internet_security_mode |
int | 连接到承载 Web 同步的 Web 服务器时使用的身份验证模式。 表示 Windows 身份验证的值 1 ，以及 SQL Server 身份验证的值 0 。 |
internet_timeout |
int | Web 同步请求过期之前的时间长度（秒）。 |
hostname |
nvarchar(128) | 指定在参数化行筛选器的 WHERE 子句中使用此函数时HOST_NAME的重载值。 |
job_login |
nvarchar(512) | 运行合并代理的 Windows 帐户，该帐户以格式域\用户名返回。 |
job_password |
sysname | 出于安全原因，始终返回值 ** 。 |
返回代码值
0（成功）或 1（失败）。
注解
sp_helpmergepullsubscription 用于合并复制。 在结果集中，返回的 last_updated 日期的格式为 yyyyMMdd hh:mm:ss.fff。
权限
只有 sysadmin 固定服务器角色的成员和db_owner固定数据库角色才能执行sp_helpmergepullsubscription。