sp_helpmergepullsubscription (Transact-SQL)

适用于SQL Server

返回有关订阅服务器中存在的请求订阅的信息。 此存储过程在订阅服务器的订阅数据库中执行。

Transact-SQL 语法约定

语法

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. 有效值为 pushpullboth

结果集

列名称 数据类型 描述
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 = Succeeded

3 = 正在进行中

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