sp_helpmergepullsubscription (Transact-SQL)
返回有关订阅服务器中存在的请求订阅的信息。此存储过程在订阅服务器的订阅数据库中执行。
语法
sp_helpmergepullsubscription [ [ @publication=] 'publication']
[ , [ @publisher=] 'publisher']
[ , [ @publisher_db=] 'publisher_db']
[ , [ @subscription_type=] 'subscription_type']
参数
[ @publication=] 'publication'
发布的名称。publication 的数据类型为 sysname,默认值为 %。如果 publication 为 %,则返回有关当前数据库中的所有合并发布和订阅的信息。[ @publisher=] 'publisher'
发布服务器的名称。publisher 的数据类型为 sysname,默认值为 %。[ @publisher_db=] 'publisher_db'
发布服务器数据库的名称。publisher_db 的数据类型为 sysname,默认值为 %。[ @subscription_type=] 'subscription_type'
指示是否显示请求订阅。subscription_type 的数据类型为 nvarchar(10),默认值为 'pull'。有效值为 'push'、'pull' 或 'both'。
结果集
列名 |
数据类型 |
说明 |
---|---|---|
subscription_name |
nvarchar(1000) |
订阅的名称。 |
publication |
sysname |
发布的名称。 |
publisher |
sysname |
发布服务器的名称。 |
publisher_db |
sysname |
发布服务器数据库的名称。 |
subscriber |
sysname |
订阅服务器的名称。 |
subscription_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 的选项,则是使用 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 = 成功 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 服务器时使用的身份验证模式。值 1 表示 Windows 身份验证,值 0 表示 SQL Server 身份验证。 |
internet_timeout |
int |
表示 Web 同步请求在多长时间之后过期的时间长度(秒)。 |
hostname |
nvarchar(128) |
当在参数化行筛选器的 WHERE 子句中使用此函数时,为 HOST_NAME 指定一个重载值。 |
job_login |
nvarchar(512) |
是用于运行合并代理的 Windows 帐户,它以 domain\username 格式返回。 |
job_password |
sysname |
出于安全原因,总是返回值“**********”。 |
返回代码值
0(成功)或 1(失败)
注释
sp_helpmergepullsubscription 用于合并复制。在结果集中,last_updated 中返回的日期的格式为 YYYYMMDD hh:mm:ss.fff。
权限
只有 sysadmin 固定服务器角色成员和 db_owner 固定数据库角色成员才能执行 sp_helpmergepullsubscription。