sp_change_subscription_properties (Transact-SQL)

更新请求订阅信息。 此存储过程在订阅服务器的订阅数据库中执行。

Transact-SQL 语法约定

语法

sp_change_subscription_properties [ @publisher = ] 'publisher' 
        , [ @publisher_db = ] 'publisher_db' 
        , [ @publication = ] 'publication' 
        , [ @property = ] 'property' 
        , [ @value = ] 'value'
    [ , [ @publication_type = ] publication_type ]

参数

• [ @publisher=] 'publisher'
  发布服务器的名称。 publisher 的数据类型为 sysname，无默认值。

• [ @publisher_db=] 'publisher_db'
  发布服务器数据库的名称。 publisher_db 的数据类型为 sysname，无默认值。

• [ @publication=] 'publication'
  发布的名称。 publication 的数据类型为 sysname，无默认值。

• [ @property=] 'property'
  要更改的属性。 property 的数据类型为 sysname。

• [ @value=] 'value'
  属性的新值。 value 的数据类型为 nvarchar(1000)，无默认值。

• [ @publication_type = ] publication_type
  指定发布的复制类型。 publication_type 的数据类型为 int，可以为以下值之一。

  值	发布类型
  0	事务性
  1	快照
  2	合并
  NULL（默认值）	发布类型是由复制决定的。 因为存储过程必须浏览多个表，因此使用此选项时的执行速度要比提供了精确发布类型时的速度慢。

下表说明项目的属性和这些属性的值。

属性	值	说明
alt_snapshot_folder		指定快照的备用文件夹的位置。 如果设置为 NULL，则将从发布服务器指定的默认位置提取快照文件。
distrib_job_login		用来运行代理的 Microsoft Windows 帐户的登录名。
distrib_job_password		用来运行代理的 Windows 帐户的密码。
distributor_login		分发服务器登录名。
distributor_password		分发服务器密码。
distributor_security_mode	1	连接分发服务器时，使用 Windows 身份验证。
	0	连接分发服务器时，使用 SQL Server 身份验证。
dts_package_name		指定 SQL Server 2000 Data Transformation Services (DTS) 包的名称。 仅当发布为事务发布或快照发布时才能指定该值。
dts_package_password		指定包上的密码。 dts_package_password 的数据类型为 sysname，默认值为 NULL，它指定密码属性保持不变。 注意 DTS 包必须具有密码。 仅当发布为事务发布或快照发布时才能指定该值。
dts_package_location		存储 DTS 包的位置。 仅当发布为事务发布或快照发布时才能指定该值。
dynamic_snapshot_location		指定保存快照文件的文件夹的路径。 仅当发布为合并发布时才能指定该值。
ftp_address		仅为保持向后兼容。
ftp_login		仅为保持向后兼容。
ftp_password		仅为保持向后兼容。
ftp_port		仅为保持向后兼容。
hostname		连接到发布服务器时使用的主机名称。
internet_login		在使用基本身份验证连接到承载 Web 同步的 Web 服务器时，合并代理所使用的登录名。
internet_password		在使用基本身份验证连接到承载 Web 同步的 Web 服务器时，合并代理使用的密码。
internet_security_mode	1	使用 Windows 集成身份验证进行 Web 同步。 建议您将基本身份验证与 Web 同步结合使用。 有关详细信息，请参阅配置 Web 同步。
	0	使用基本身份验证进行 Web 同步。 注意 Web 同步要求与 Web 服务器存在 SSL 连接。
internet_timeout		Web 同步请求过期之前的时间长度（秒）。
internet_url		表示 Web 同步的复制侦听器所在位置的 URL。
merge_job_login		用来运行代理的 Windows 帐户的登录名。
merge_job_password		用来运行代理的 Windows 帐户的密码。
publisher_login		发布服务器登录名。 只有对合并发布的订阅才支持更改 publisher_login。
publisher_password		发布服务器密码。 只有对合并发布的订阅才支持更改 publisher_password。
publisher_security_mode	1	连接发布服务器时，使用 Windows 身份验证。 只有对合并发布的订阅才支持更改 publisher_security_mode。
	0	连接发布服务器时，使用 SQL Server 身份验证。
use_ftp	True	使用 FTP 代替常规协议来检索快照。
	False	使用常规协议来检索快照。
use_web_sync	true	启用 Web 同步。
	false	禁用 Web 同步。
working_directory		使用文件传输协议 (FTP) 传输快照文件时，用于临时存储发布的数据和架构文件的工作目录的名称。

返回代码值

0（成功）或 1（失败）

注释

sp_change_subscription_properties 用于所有类型的复制。

sp_change_subscription_properties 用于请求订阅。

对于 Oracle 发布服务器，publisher_db 将被忽略，因为 Oracle 只允许每个服务器实例对应一个数据库。

权限

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

请参阅

参考

sp_addmergepullsubscription (Transact-SQL)

sp_addmergepullsubscription_agent (Transact-SQL)

sp_addpullsubscription (Transact-SQL)

sp_addpullsubscription_agent (Transact-SQL)

系统存储过程 (Transact-SQL)

概念

查看和修改请求订阅属性