sp_changemergepullsubscription (Transact-SQL)

2025-06-23

适用范围：SQL Server

更改合并请求订阅的属性。此存储过程在订阅服务器的订阅数据库中执行。

语法

sp_changemergepullsubscription
    [ [ @publication = ] N'publication' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @publisher_db = ] N'publisher_db' ]
    [ , [ @property = ] N'property' ]
    [ , [ @value = ] N'value' ]
[ ; ]

参数

[ @publication = ] N'publication'

发布的名称。 @publication为 sysname，默认值为 %.

[ @publisher = ] N'publisher'

发布服务器的名称。 @publisher为 sysname，默认值为 %.

[ @publisher_db = ] N'publisher_db'

发布服务器数据库的名称。 @publisher_db为 sysname，默认值为 %.

[ @property = ] N'property'

要更改的属性的名称。 @property 为 sysname，可以是下表中的值之一。

[ @value = ] N'value'

指定属性的新值。 @value为 nvarchar（255），可以是下表中的值之一。

属性	价值	说明
`alt_snapshot_folder`		快照文件夹的存储位置（如果该位置不同于默认位置或是默认位置之外的位置）。
`description`		对该合并请求订阅的说明。
`distributor`		分发服务器的名称。
`distributor_login`		分发服务器上用于 SQL Server 身份验证的登录 ID
`distributor_password`		分发服务器上用于 SQL Server 身份验证的密码（已加密）。
`distributor_security_mode`	`1`	连接分发服务器时，使用 Windows 身份验证。
	`0`	连接到分发服务器时使用 SQL Server 身份验证。
`dynamic_snapshot_location`		保存快照文件的文件夹的路径。
`ftp_address`		仅为向后兼容而提供。分发服务器的文件传输协议（FTP）服务的网络地址。
`ftp_login`		仅为向后兼容而提供。用于连接到 FTP 服务的用户名。
`ftp_password`		仅为向后兼容而提供。用于连接到 FTP 服务的用户密码。
`ftp_port`		仅为向后兼容而提供。分发服务器的 FTP 服务的端口号。
`hostname`		指定在联接筛选器或逻辑记录关系的子句中使用`WHERE`此函数的时间的值`HOST_NAME()`。
`internet_login`		在使用基本身份验证连接到承载 Web 同步的 Web 服务器时，合并代理所使用的登录名。
`internet_password`		在使用基本身份验证连接到承载 Web 同步的 Web 服务器时，合并代理所使用的登录密码。
`internet_security_mode`	`1`	在连接到承载 Web 同步的 Web 服务器时使用 Windows 身份验证。
	`0`	在连接到承载 Web 同步的 Web 服务器时使用基本身份验证。
`internet_timeout`		Web 同步请求过期之前的时间长度（秒）。
`internet_url`		表示 Web 同步复制侦听器位置的 URL。
`merge_job_login`		用来运行代理的 Windows 帐户的登录名。
`merge_job_password`		用来运行代理的 Windows 帐户的密码。
`priority`		仅适用于向后兼容性;请改为在发布服务器上运行 sp_changemergesubscription 以修改订阅的优先级。
`publisher_login`		发布服务器上用于 SQL Server 身份验证的登录 ID。
`publisher_password`		在发布服务器上用于 SQL Server 身份验证的密码（加密）。
`publisher_security_mode`	`0`	连接到发布服务器时使用 SQL Server 身份验证。
	`1`	连接发布服务器时，使用 Windows 身份验证。
	`2`	同步触发器使用静态 `sysservers` 条目执行远程过程调用（RPC），并且发布服务器必须在表中定义为 `sysservers` 远程服务器或链接服务器。
`sync_type`	`automatic`	已发布表的架构和初始数据将首先传输到订阅服务器。
	`none`	订阅服务器已经具有已发布表的架构和初始数据；将始终传输系统表和数据。
`use_ftp`	`true`	使用 FTP 而不是典型的协议来检索快照。
	`false`	使用典型协议来检索快照。
`use_web_sync`	`true`	可以通过 HTTP 同步订阅。
	`false`	无法通过 HTTP 同步订阅。
`use_interactive_resolver`	`true`	在调解过程中使用交互式冲突解决程序。
	`false`	不使用交互式解析程序。
`working_directory`		指定该选项时，使用 FTP 传输快照文件的目录的完全限定路径。
`NULL`（默认值）		返回@property支持的值列表。

返回代码值

0（成功）或 1（失败）。

注解

sp_changemergepullsubscription 用于合并复制。

假定当前服务器和当前数据库分别是订阅服务器和订阅服务器数据库。

更改代理登录名或密码之后，必须先停止并重新启动代理，然后更改才能生效。

权限

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

反馈

此页面是否有帮助？