sp_changemergepublication (Transact-SQL)

项目
12/15/2008

更新日期： 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

请参阅

更改历史记录

发布日期	历史记录
2006 年 12 月 12 日	新增内容：增加了关于 generation_leveling_threshold 值的信息。

sp_changemergepublication (Transact-SQL)

语法

参数

返回代码值

备注

权限

示例

请参阅

参考

其他资源

帮助和信息

更改历史记录

其他资源