Configure Entity Update Retry
Learn how to request retry-based conflict resolution for tenant updates so that your tenant can automatically retry updates that fail because of simultaneous-update conflicts.
Enable retry-based conflict resolution for tenant by setting repeatAllOperationsOnConflict to true in the tenant's physical configuration. When enabled, the system automatically retries an entire update request that encounters a simultaneous-update conflict, using configurable exponential backoff parameters (BACK_OFF_*). Nested attribute behavior is controlled separately through enableNestedPartialOverride or disableNestedPartialOverride, which control how nested attributes are applied during updates. Enable repeatAllOperationsOnConflict when the original request intent must be preserved and the updates are safe to reapply.
Prerequisites
Before you begin, make sure the following conditions are met:
- You must have identified the tenant that requires the change.
-
You must have confirmedthat retry-related settings, such as
repeatAllOperationsOnConflictandenableNestedPartialOverride, are applied in the tenant's physical configuration. - You must have access to your organization's Reltio support process for submitting a configuration request.
Enable retry logic in the physical configuration
Contact Reltio Support to update your tenant's physical configuration with the following steps.
- Submit a support request with Reltio and specify that you want to enable retry-based conflict resolution for tenant updates in your tenant's physical configuration. Include the business reason for the change so Reltio support can review and apply the requested update.
-
In the ticket, specify that
repeatAllOperationsOnConflictis set totrue. -
If you also want partial override behavior for nested attributes, specify that
enableNestedPartialOverridemust be enabled for your tenant.
Result
- The system retries operations that fail due to simultaneous update conflicts.
- When a conflict is detected, the system restarts and re-executes the entire operation from the beginning using the current state of the object.
Nested attribute partial override
The enableNestedPartialOverride parameter enables partial override behavior for nested attributes. When enabled and a request contains a partial override for a nested attribute, the system processes that specific request with retry logic, as if repeatAllOperationsOnConflict were set to true . This behavior applies only to the request that contains the partial override.
Conflict resolution parameters
Use the following parameters to configure how the system handles update conflicts across simultaneous requests.
| Parameter | Type | Default | Description | Usage context |
|---|---|---|---|---|
repeatAllOperationsOnConflict | Boolean | False | Enables retry logic when a conflict is detected. Retries the original request to simulate sequential consistency. | Use to preserve request intent without enforcing order. |
enableNestedPartialOverride | Boolean | False | Allows partial updates to nested attributes to be merged with existing values. | Use for nested attribute updates where partial data should be retained. |
disableNestedPartialOverride | Boolean | False | Disables nested partial override for a specific request (causes overwrite of the whole nested attribute). | Use to overwrite the entire nested attribute in a given request. |