KeepPartitionChanges Property

SQL-DMO

SQL-DMO

KeepPartitionChanges Property

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

Applies To
MergePublication2 Object  
Syntax

object.KeepPartitionChanges [=value]

Parts

object

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.

When 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" are returned.