Skip to content

Commit

Permalink
docs: source-mongodb docs updates
Browse files Browse the repository at this point in the history
  • Loading branch information
mdibaiee committed Sep 22, 2023
1 parent 70c7d22 commit 77af482
Showing 1 changed file with 17 additions and 5 deletions.
22 changes: 17 additions & 5 deletions site/docs/reference/Connectors/capture-connectors/mongodb.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,18 @@ You'll need:
[Role-Based Access
Control](https://www.mongodb.com/docs/manual/core/authorization/) for more
information.
* Read access to the `local` database and `oplog.rs` collection in that
database are also necessary.

In order to grant these permissions with a command like so:
```
use <your-database-name>
db.createUser({
user: "<username>",
pwd: "<password>",
roles: [ "read", {role: "read", db: "local"} ]
})
```
* ReplicaSet enabled on your database, see [Deploy a Replica
Set](https://www.mongodb.com/docs/manual/tutorial/deploy-replica-set/).
Expand Down Expand Up @@ -89,8 +101,8 @@ connector's ability to do this depends on the size of the [replica set
oplog](https://www.mongodb.com/docs/manual/core/replica-set-oplog/), and in
certain circumstances, when the pause has been long enough for the oplog to have
evicted old change events, the connector will need to re-do the backfill to
ensure data consistency. In such cases, the connector will error out the first
time it is run with a message indicating that it is going to re-do a backfill on
the next run, and it will be restarted by Flow runtime. This new run of the
connector will do a backfill and once fully caught up, will start capturing
change events.
ensure data consistency. In such cases, the connector will error, and to resolve
this case, first try to increase the size of your oplog to avoid this issue in
the future, and then you need to remove the binding that is unable to be
captured, publishing your task, and then adding the binding back so the backfill
is restarted.

0 comments on commit 77af482

Please sign in to comment.