Skip to content

Add a section for mongodb cdc connector caveats #4285

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.

Sign up for GitHub

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

Merged
merged 5 commits into from
Aug 15, 2025
Merged

Add a section for mongodb cdc connector caveats #4285

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
f349c08
mongodb: add caveats section to setup page
jgao54 Aug 14, 2025
1a62ebb
nit
jgao54 Aug 14, 2025
d9e7711
nit
jgao54 Aug 14, 2025
dc2edfd
Update docs/integrations/data-ingestion/clickpipes/mongodb/index.md
jgao54 Aug 14, 2025
a040b2e
Update docs/integrations/data-ingestion/clickpipes/mongodb/index.md
jgao54 Aug 14, 2025
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
9 changes: 9 additions & 0 deletions docs/integrations/data-ingestion/clickpipes/mongodb/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -92,3 +92,12 @@ You can configure the advanced settings if needed. A brief description of each s
## What's next? {#whats-next}

Once you've set up your ClickPipe to replicate data from MongoDB to ClickHouse Cloud, you can focus on how to query and model your data for optimal performance.

## Caveats {#caveats}

Here are a few caveats to note when using this connector:

- We require MongoDB version 5.1.0+.
- We use MongoDB's native Change Streams API for CDC, which relies on the MongoDB oplog to capture real-time changes.
- Documents from MongoDB are replicated into ClickHouse as JSON type by default. This allows for flexible schema management and makes it possible to use the rich set of JSON operators in ClickHouse for querying and analytics. You can learn more about querying JSON data [here](https://clickhouse.com/docs/sql-reference/data-types/newjson).
- Self-serve PrivateLink configuration is not currently available. If you are on AWS and require PrivateLink, please reach out to db-integrations-support@clickhouse.com or create a support ticket — we will work with you to enable it.