KeepPartitionChanges Property

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The KeepPartitionChanges property specifies whether a Publisher retains information about what data a Subscriber owns in a horizontally partitioned merge replication topology.

Syntax

object
.KeepPartitionChanges [=value]

Parts

  • object
    An expression that evaluates to an object in the Applies To list
  • value
    TRUE or FALSE

Data Type

Boolean

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetKeepPartitionChanges(LPBOOL pRetVal);
HRESULT SetKeepPartitionChanges(BOOL NewValue);

Remarks

In a horizontally partitioned merge replication topology, a Publisher retains information about deletes and updates. If the KeepPartitionChanges property is set to TRUE, the Publisher can determine which row belongs to which Subscriber. Only changes to rows belonging to a particular Subscriber are replicated.

For example, if the Subscriber is responsible only for tracking sales in northern Europe, rows updated at the Publisher will be kept in a special table so that the Subscriber only receives updated rows related to sales in northern Europe when the Subscriber and the Publisher synchronize. Setting KeepPartitionChanges to TRUE can result in improved performance because Subscribers only receive the necessary updates.

If KeepPartitionChanges is set to FALSE (default), no extra information about updates or deletes is kept at the Publisher.

Note

If an application calls KeepPartitionChanges on an instance of SQL Server version 7.0, the constant, SQLDMO_E_SQL80ONLY, and the message "This property or method requires Microsoft SQL Server 2000 or later" are returned.

Applies To:

MergePublication2 Object