Skip to content

Commit cece41e

Browse files
Chris Choschmalliso
authored andcommitted
DOCSP-19879: copy existing admonition (#216)
* DOCSP-19879: copy existing admonition
1 parent b196ff5 commit cece41e

File tree

4 files changed

+18
-6
lines changed

4 files changed

+18
-6
lines changed
Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
.. note:: Data Copy Can Produce Duplicate Events
2+
3+
If any system changes the data in the database while the source connector
4+
converts existing data from it, MongoDB may produce duplicate change
5+
stream events to reflect the latest changes. Since the change stream
6+
events on which the data copy relies are idempotent, the copied data is
7+
eventually consistent.

source/sink-connector/configuration-properties/connector-message.txt

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -40,10 +40,10 @@ Settings
4040
|
4141
| Consider the batch that contains the following records:
4242

43-
.. code-block:: none
44-
:copyable: false
43+
.. code-block:: none
44+
:copyable: false
4545

46-
[ 1, 2, 3, 4, 5 ]
46+
[ 1, 2, 3, 4, 5 ]
4747

4848
| When set to ``0``, the connector performs a single bulk write for
4949
the entire batch.
@@ -52,10 +52,10 @@ Settings
5252
record in the batch, for a total of five bulk writes as shown in
5353
the following example:
5454

55-
.. code-block:: none
56-
:copyable: false
55+
.. code-block:: none
56+
:copyable: false
5757

58-
[1], [2], [3], [4], [5]
58+
[1], [2], [3], [4], [5]
5959

6060
| **Default**: ``0``
6161
| **Accepted Values**: An integer

source/source-connector/configuration-properties/copy-existing.txt

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,9 @@ Settings
4545
collection data after the connector starts the copy process, the
4646
connector creates events for the changes after it completes the copy
4747
process.
48+
49+
.. include:: /includes/copy-existing-admonition.rst
50+
4851
| **Default**:``false``
4952
| **Accepted Values**: ``true`` or ``false``
5053

source/source-connector/usage-examples/copy-existing-data.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,8 @@ specifying the following configuration options in your source connector:
6767
Your source connector copies your collection by creating change event documents
6868
that describe inserting each document into your collection.
6969

70+
.. include:: /includes/copy-existing-admonition.rst
71+
7072
To learn more about change event documents, see the
7173
:ref:`Change Streams <source-connector-fundamentals-change-event>` guide.
7274

0 commit comments

Comments
 (0)