sp_helppullsubscription (Transact-SQL)

显示订阅服务器上的一个或多个订阅的有关信息。 此存储过程在订阅服务器的订阅数据库中执行。

Transact-SQL 语法约定

语法

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)

sp_droppullsubscription (Transact-SQL)

系统存储过程 (Transact-SQL)