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)