sp_changemergepublication (Transact-SQL)
更新日期: 2006 年 12 月 12 日
更改合并发布的属性。此存储过程在发布服务器的发布数据库中执行。
语法
sp_changemergepublication [ @publication= ] 'publication'
[ , [ @property= ] 'property' ]
[ , [ @value= ] 'value' ]
[ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
[ , [ @force_reinit_subscription = ] force_reinit_subscription ]
参数
- [ @publication = ] 'publication'
发布的名称。publication 的数据类型为 sysname,无默认值。
- [ @property=] 'property'
给定发布要更改的属性。property 的数据类型为 sysname,可以是下表所列值之一。
[ @value=] 'value'
指定属性的新值。value 的数据类型为 nvarchar(255),可以是下表所列值之一。下表说明了可更改的发布属性以及对这些属性值的限制。
属性
[ @force_invalidate_snapshot = ] force_invalidate_snapshot
确认此存储过程所执行的操作是否会使现有快照失效。force_invalidate_snapshot 的数据类型为 bit,默认值为 0。0 指定更改发布不会导致快照无效。如果该存储过程检测到更改确实需要新的快照,则会发生错误,并且不执行任何更改。
1 指定更改发布可能导致快照无效。如果存在需要新快照的现有订阅,则提供该现有快照的权限,以便将该快照标记为过时,并生成新快照。
有关在更改时需要生成新快照的属性,请参阅“备注”部分。
[ @force_reinit_subscription = ] force_reinit_subscription
确认此存储过程所执行的操作是否需要重新初始化现有订阅。force_reinit_subscription 的数据类型为 bit,默认值为 0。0 指定更改发布不会导致要求重新初始化订阅。如果该存储过程检测到更改将需要重新初始化现有订阅,则会发生错误,并且不执行任何更改。
1 指定更改发布会导致重新初始化现有订阅,并提供重新初始化订阅的权限。
有关在更改时需要重新初始化所有现有订阅的属性,请参阅“备注”部分。
返回代码值
0(成功)或 1(失败)
备注
sp_changemergepublication 用于合并复制。
更改下列属性需要生成新的快照,因而必须将 force_invalidate_snapshot 参数的值指定为 1。
- alt_snapshot_folder
- compress_snapshot
- dynamic_filters
- ftp_address
- ftp_login
- ftp_password
- ftp_port
- ftp_subdirectory
- post_snapshot_script
- publication_compatibility_level(仅适用于 80SP3)
- pre_snapshot_script
- snapshot_in_defaultfolder
- sync_mode
- use_partition_groups
更改下列属性需要重新初始化现有订阅,因而必须将 force_reinit_subscription 参数的值指定为 1。
- dynamic_filters
- validate_subscriber_info
若要使用 publish_to_active_directory 列出 Active Directory 的发布对象,必须已在 Active Directory 中创建了 SQL Server 对象。
权限
只有 sysadmin 固定服务器角色的成员或 db_owner 固定数据库角色的成员才能执行 sp_changemergepublication。
示例
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';
-- Disable DDL replication for the publication.
USE [AdventureWorks]
EXEC sp_changemergepublication
@publication = @publication,
@property = N'replicate_ddl',
@value = 0,
@force_invalidate_snapshot = 0,
@force_reinit_subscription = 0;
GO
请参阅
参考
sp_addmergepublication (Transact-SQL)
sp_dropmergepublication (Transact-SQL)
sp_helpmergepublication (Transact-SQL)
复制存储过程 (Transact-SQL)
其他资源
How to: View and Modify Publication Properties (Replication Transact-SQL Programming)
更改发布和项目属性
帮助和信息
更改历史记录
发布日期 | 历史记录 |
---|---|
2006 年 12 月 12 日 |
|