sp_change_subscription_properties (Transact-SQL)

  • 项目

适用于：SQL ServerAzure 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' 要更改的属性。 属性 为 sysname。

[ @value = ] 'value' 属性的新值。 值为 nvarchar（1000），没有默认值。

[ @publication_type = ] publication_type指定发布的副本 (replica)类型。 publication_type为 int，可以是这些值之一。

值 Publication type
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是默认为 NULL 的 sysname，它指定密码属性将保持不变。

注意：DTS 包必须具有密码。

仅当发布为事务发布或快照发布时才能指定该值。
dts_package_location 存储 DTS 包的位置。 仅当发布为事务发布或快照发布时才能指定该值。
dynamic_快照_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 同步结合使用。 有关详细信息，请参阅 Configure Web Synchronization。
0 使用基本身份验证进行 Web 同步。

注意：Web 同步需要与 Web 服务器的 TLS 连接。
internet_timeout Web 同步请求过期之前的时间长度（秒）。
internet_url 表示 Web 同步副本 (replica)侦听器位置的 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用于所有类型的副本 (replica)。

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)