Skip to content

Guides

Topic-by-topic walk-throughs of every shipping DTDE feature.

Start here

Guide What it covers Time
Getting started Sharded DbContext, three logical shards, table/database/mixed mode, working LINQ query — end to end. 5 min

Sharding

Guide What it covers
Sharding guide All four strategies (ShardBy, ShardByHash, ShardByDate, UseManualSharding), the three storage modes, shard groups for per-entity topologies, and routing rules.
Temporal guide Bi-temporal entities, ValidAt<T>(date), AllVersions<T>(), point-in-time queries.

Transactions and bulk operations

Guide What it covers
Cross-shard transactions BeginCrossShardTransactionAsync, the 2PC protocol, savepoints, read-after-write inside a transaction, isolation levels, retry policy.
Bulk operations BulkInsertAsync, BulkUpdateAsync, BulkDeleteAsync, ExecuteStreamingAsync, pluggable IBulkInsertProvider (SqlBulkCopy / PG COPY / etc.).
Transaction log and recovery ITransactionLog, FileBasedTransactionLog, coordinator.RecoverAsync(), the 2PC recovery rule.

Migration and reference

Guide What it covers
Migration guide Migrating an existing EF Core project to DTDE.
API reference Public type catalogue.
Architecture Internal layering, the three projects, key abstractions.
Configuration Every option on DtdeOptionsBuilder, JSON shard config schema.
Troubleshooting Common errors and fixes.

Samples

Eight runnable Web API samples — one per concept. See samples/.