sp_helppullsubscription (Transact-SQL)

适用于SQL Server Azure SQL 托管实例

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

Transact-SQL 语法约定

语法

sp_helppullsubscription
    [ [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @publication = ] N'publication' ]
    [ , [ @show_push = ] N'show_push' ]
[ ; ]

参数

[ @publisher = ] N'publisher'

远程服务器的名称。 @publishersysname,默认值 %为 ,它将返回所有发布服务器的信息。

[ @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年份、MMdd、日、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年份、MMdd、日、HH小时、 mm ss分钟、秒和nnn毫秒。
job_login nvarchar(512) 分发代理在哪个 Windows 帐户下运行,该帐户以格式\用户名返回。
job_password sysname 出于安全原因,始终返回值 **********

返回代码值

0(成功)或 1(失败)。

注解

sp_helppullsubscription 用于快照复制和事务复制。

权限

只有 sysadmin 固定服务器角色的成员db_owner固定数据库角色的成员才能执行sp_helppullsubscription