Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: source-mongodb docs updates #1196

Merged
merged 3 commits into from
Oct 10, 2023
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
mdibaiee marked this conversation as resolved.
Show resolved Hide resolved
database are also necessary.

In order to grant these permissions with a command like so:
```
use admin;
db.createUser({
user: "<username>",
pwd: "<password>",
roles: [ "readAnyDatabase" ]
})
```

* 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
mdibaiee marked this conversation as resolved.
Show resolved Hide resolved
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.
Loading