Convex to Azure Synapse Integration

How Datrise loads Convex into Azure Synapse

Datrise syncs Convex's documents, tables, functions, indexes, mutations, and queries into Azure Synapse as a typed table per source entity. Flexible or custom fields land in NVARCHAR(MAX) JSON columns, and timestamps such as created, updated, and status changes are typed as datetime2.

Sync is incremental: Datrise uses COPY into staging, then a MERGE on stable id, so re-runs update only what changed. Hash distribution on the join id with date partitioning on facts. Synapse dedicated pools reward good hash-distribution choices, so Datrise distributes on entity ids to avoid data-movement-heavy joins.

Ideal for Azure analytics estates feeding Power BI.

Endpoints

Convex: Reactive backend with a document database.

Azure Synapse: Microsoft analytics workspace with SQL pools.

How Convex entities map to Azure Synapse

Convex entity	Azure Synapse object	Notes
documents	`convex_documents`	id PK · custom fields → NVARCHAR(MAX) JSON columns
tables	`convex_tables`	id PK · linked to convex_documents
functions	`convex_functions`	id PK · linked to convex_documents
indexes	`convex_indexes`	id PK · linked to convex_documents

FAQ

How does Datrise handle Convex's custom fields in Azure Synapse?

Flexible values are stored as NVARCHAR(MAX) JSON columns, so new fields don't require a migration; strongly-typed fields — dates, numbers, and references — are promoted to native Azure Synapse types.

How does the Convex to Azure Synapse sync stay up to date?

It runs incrementally — Datrise uses COPY into staging, then a MERGE on stable id.

Related pipelines

Early access

Connect Convex to Azure Synapse the easy way

Skip brittle scripts and manual exports. Join the waitlist to get a guided setup, AI-assisted mapping, and reliable incremental sync for this integration.