sp_changemergepullsubscription (Transact-SQL)

适用于SQL Server

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

Transact-SQL 语法约定

语法

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'

要更改的属性的名称。 @propertysysname,可以是下表中的值之一。

[ @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