Skip to content

Commit dd97981

Browse files
authored
DOCSP-43808 document non idempotent inserts (#173)
* DOCSP-43808-Document-non-idempotent-inserts * Rewording. * Editorial. * Removing unnecessary word. * Responding to internal feedback.
1 parent 426a43c commit dd97981

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

source/jobs/sync-jobs.txt

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,20 @@ Recoverability
4040

4141
.. include:: /includes/fact-cdc-recoverable.rst
4242

43+
Behavior
44+
--------
45+
46+
Sync jobs are non-idempotent by default. Relational Migrator inserts new
47+
documents and embeded arrays each time a job is run, with the option to
48+
delete each existing collection at the start of the sync dialogue. You
49+
can enable idempotency to delete inserts from the previous sync job
50+
automatically.
51+
52+
To enable idempotent inserts for documents and embedded arrays, set
53+
``migrator.engine.transform.idempotency: true`` in the
54+
``user.properties`` file. Enabling idempotency may have substantial
55+
performance impact on large jobs.
56+
4357
Get Started
4458
-----------
4559

@@ -67,4 +81,4 @@ You can perform the following tasks from the **Data Migration** tab.
6781
Stop </jobs/stopping-jobs>
6882
Recover </jobs/recover-jobs>
6983
Pause & Resume with Kafka </jobs/pause-resume-kafka-jobs>
70-
Data Verification </jobs/data-verification/data-verification>
84+
Data Verification </jobs/data-verification/data-verification>

0 commit comments

Comments
 (0)