MergeArticle.CompensateForErrors Property

Definition

Gets or sets whether compensating actions are taken when errors are encountered during synchronization.

public:
 property bool CompensateForErrors { bool get(); void set(bool value); };
public bool CompensateForErrors { get; set; }
member this.CompensateForErrors : bool with get, set
Public Property CompensateForErrors As Boolean

Property Value

A Boolean value. If true, changes that cannot be applied at a Subscriber or Publisher during synchronization always lead to compensating actions to undo the change. If false, the default, compensating actions are not attempted when an error occurs.

Remarks

By design, the default value of false for the CompensateForErrors property results in non-convergence which requires corrective action by an administrator.

If the source table for an article is already published in another publication, then the value of CompensateForErrors must be the same for both articles.

When CompensateForErrors is true, one incorrectly configured Subscriber that generates an error can cause changes at other Subscribers and Publishers to be undone.

When CompensateForErrors is false, errors are still logged, and during subsequent synchronizations, the Merge Agent continues to attempt to apply the changes until successful.

The CompensateForErrors property can be retrieved by members of the sysadmin fixed server role at the Publisher and at the Subscriber (for republishing Subscribers). It can also be retrieved by members of the db_owner fixed database role on the publication database, by members of the replmonitor fixed database role at the Distributor, and by users who are members of the publication access list (PAL).

The CompensateForErrors property can be set by members of the sysadmin fixed server role at the Publisher. It can also be set by members of the db_owner fixed database role on the publication database.

Retrieving CompensateForErrors is equivalent to executing sp_helpmergearticle (Transact-SQL).

Setting CompensateForErrors is equivalent to executing sp_addmergearticle (Transact-SQL) or sp_changemergearticle (Transact-SQL).

Applies to