MongoDB to Synapse
real-time replication
TwinCommit replicates MongoDB to Azure Synapse Analytics in real time by reading the MongoDB transaction log and applying every committed change exactly once and in commit order. Use it to feed Synapse with live MongoDB data for analytics, AI and reporting, with no triggers or capture tables on the source.
MongoDB
log reader
commit-ordered · exactly-once
Synapse
native writer
How capture works on MongoDB
TwinCommit opens change streams on replica sets and sharded clusters, persists resume tokens with the checkpoint, and keeps multi-document transactions intact.
Prerequisites
- ✓Replica set or sharded cluster (change streams need an oplog)
- ✓changeStream and find privileges on watched databases
- ✓Pre- and post-images enabled for full before/after values (optional)
How apply works on Synapse
Micro-batches are staged as Parquet in Azure Data Lake Storage, loaded with COPY INTO and applied with MERGE in one transaction together with the checkpoint. Tables are created hash-distributed on the primary key.
Requirements
- ✓An ADLS Gen2 staging container
- ✓A service principal or managed identity with db_ddladmin and db_datawriter
- ✓ADMINISTER DATABASE BULK OPERATIONS for COPY INTO
Setup
Set up MongoDB → Synapse in four steps
- 1
Prepare MongoDB
Run twincommit check. It verifies replica set or sharded cluster (change streams need an oplog) and the other prerequisites, and prints the exact fix for anything missing.
- 2
Point at Synapse
Add a target block for Synapse. TwinCommit can generate target DDL with twincommit ddl -apply.
- 3
Snapshot
twincommit snapshot copies each table under a brief share lock and records the exact log position.
- 4
Stream
twincommit run streams every committed change from that position, exactly once and in commit order.
source:
type: mongodb
uri: ${MONGODB_URI}
target:
type: synapse
server: acme-dw.sql.azuresynapse.net
database: replica_dw
auth: managed_identity
staging: abfss://staging@acmelake.dfs.core.windows.net/twincommit/
tables:
- source: sales.orders
- source: sales.customersMongoDB to Synapse replication FAQ
How does TwinCommit replicate MongoDB to Synapse?
+
TwinCommit reads changes from the MongoDB transaction log, buffers them per transaction, and applies each committed transaction to Synapse in commit order. Micro-batches are staged as Parquet in Azure Data Lake Storage, loaded with COPY INTO and applied with MERGE in one transaction together with the checkpoint. Tables are created hash-distributed on the primary key.
Does MongoDB to Synapse replication need triggers or capture tables?
+
No. TwinCommit reads the MongoDB log directly and creates no objects in the source database.
Is MongoDB to Synapse replication exactly-once?
+
Yes. TwinCommit commits its checkpoint in the same Synapse transaction as the data, so a crash or restart never loses or duplicates a transaction.
What MongoDB versions are supported?
+
MongoDB 5.0–8.x · MongoDB Atlas · replica sets and sharded clusters.
Stream MongoDB to Synapse today.
Download the free Developer edition, or have one of our replication engineers walk you through a migration plan.