sp_change_subscription_properties (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)
其他资源
How to: View and Modify Pull Subscription Properties (Replication Transact-SQL Programming)