EntityFrameworkCore.DynamoDb
10.2.0
See the version list below for details.
dotnet add package EntityFrameworkCore.DynamoDb --version 10.2.0
NuGet\Install-Package EntityFrameworkCore.DynamoDb -Version 10.2.0
<PackageReference Include="EntityFrameworkCore.DynamoDb" Version="10.2.0" />
<PackageVersion Include="EntityFrameworkCore.DynamoDb" Version="10.2.0" />
<PackageReference Include="EntityFrameworkCore.DynamoDb" />
paket add EntityFrameworkCore.DynamoDb --version 10.2.0
#r "nuget: EntityFrameworkCore.DynamoDb, 10.2.0"
#:package EntityFrameworkCore.DynamoDb@10.2.0
#addin nuget:?package=EntityFrameworkCore.DynamoDb&version=10.2.0
#tool nuget:?package=EntityFrameworkCore.DynamoDb&version=10.2.0
EntityFrameworkCore.DynamoDb
EF Core Provider for AWS DynamoDB
Documentation: https://dynamodb-ef-core.layeredcraft.dev/
Contributing: CONTRIBUTING.md
Write EF Core models against DynamoDB tables, compose queries with LINQ, and let the provider translate supported query shapes into PartiQL executed through the AWS SDK.
Installation
| Provider package | Target framework | EF Core | .NET |
|---|---|---|---|
EntityFrameworkCore.DynamoDb 10.x |
net10.0 |
10.0.x | .NET 10 |
EntityFrameworkCore.DynamoDb 11.x |
net11.0 |
11.0.x | .NET 11 |
Each package targets one framework and one EF Core major version. Match the provider's major
version to your EF Core major version: 11.x packages cannot be installed in a net10.0 project,
and 10.x packages do not support EF Core 11. The exact EF Core range is listed on each package's
NuGet page — for example, 10.2.0 requires EF Core 10.0.14 or later 10.0.x, and 11.0.0 requires
EF Core 11.0.0 or later 11.0.x.
# .NET 10 / EF Core 10
dotnet add package EntityFrameworkCore.DynamoDb --version 10.2.0
# .NET 11 / EF Core 11
dotnet add package EntityFrameworkCore.DynamoDb --version 11.0.0
Use the latest release of the line that matches your EF Core version. Always pass --version on
.NET 10: without it, NuGet selects the newest stable package, which is an 11.x package that cannot
be installed in a net10.0 project. Packages with a -preview suffix are CI builds from main;
do not use them in production.
See Choose a package version for central package management and multi-targeted projects.
Review the limitations before adopting the provider; DynamoDB's access-pattern model means some EF Core features and LINQ shapes are not supported.
Why It Exists
- Brings an EF Core-style modeling and querying experience to DynamoDB.
- Translates supported LINQ queries into DynamoDB PartiQL.
- Supports DynamoDB-focused mapping concepts such as partition keys, sort keys, and secondary indexes.
Quick Look
using Microsoft.EntityFrameworkCore;
public sealed class AppContext : DbContext
{
public DbSet<User> Users => Set<User>();
public DbSet<Order> Orders => Set<Order>();
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
=> optionsBuilder.UseDynamo(options =>
{
options.ConfigureDynamoDbClientConfig(config =>
{
config.ServiceURL = "http://localhost:8000";
config.AuthenticationRegion = "us-east-1";
config.UseHttp = true;
});
});
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<User>(b =>
{
b.ToDynamoTable("App");
b.HasPartitionKey(x => x.PK);
b.HasSortKey(x => x.SK);
});
modelBuilder.Entity<Order>(b =>
{
b.ToDynamoTable("App");
b.HasPartitionKey(x => x.PK);
b.HasSortKey(x => x.SK);
});
}
}
public sealed class User
{
public required string PK { get; set; }
public required string SK { get; set; }
public required string Email { get; set; }
public required string DisplayName { get; set; }
}
public sealed class Order
{
public required string PK { get; set; }
public required string SK { get; set; }
public required string Status { get; set; }
public decimal Total { get; set; }
}
var user = await context.Users
.Where(x => x.PK == "USER#42" && x.SK == "PROFILE")
.SingleAsync();
var openOrders = await context.Orders
.Where(x => x.PK == "USER#42" && x.SK.StartsWith("ORDER#") && x.Status == "Pending")
.OrderBy(x => x.SK)
.ToListAsync();
Current Scope
- Query execution is asynchronous only, including generated precompiled queries.
- Precompiled-query and NativeAOT support are experimental. See the documented restrictions before using them in production.
SaveChangesAsyncis implemented for Added/Modified/Deleted root entities.- Synchronous
SaveChangesis not supported (DynamoDB API is async-only). - LINQ support is partial; use
docs/querying/operators.mdas the source of truth for supported query shapes. - Table mapping, key mapping, complex properties and complex collections, and secondary-index metadata are supported. Owned entity types are not supported; use complex types instead.
- Optimistic concurrency is opt-in via
.IsConcurrencyToken()/[ConcurrencyCheck]; token values are application-managed.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- AWSSDK.DynamoDBv2 (>= 4.0.109.3)
- Humanizer.Core (>= 3.0.10)
- Microsoft.EntityFrameworkCore (>= 10.0.14 && < 11.0.0)
- Microsoft.Extensions.Caching.Abstractions (>= 10.0.14 && < 11.0.0)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.14 && < 11.0.0)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14 && < 11.0.0)
- Microsoft.Extensions.Options (>= 10.0.14 && < 11.0.0)
- Microsoft.Extensions.Primitives (>= 10.0.14 && < 11.0.0)
NuGet packages (1)
Showing the top 1 NuGet packages that depend on EntityFrameworkCore.DynamoDb:
| Package | Downloads |
|---|---|
|
SharpMud.Persistence.DynamoDb
DynamoDB provider for SharpMud.Persistence - AddSharpMudDynamoDbPersistence(...) via the EntityFrameworkCore.DynamoDb provider. |
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 11.0.1-preview.149 | 58 | 11/14/2026 |
| 11.0.1-preview.148 | 66 | 11/14/2026 |
| 11.0.0 | 161 | 11/13/2026 |
| 11.0.0-preview.147 | 54 | 11/13/2026 |
| 11.0.0-preview.146 | 55 | 11/13/2026 |
| 11.0.0-preview.145 | 55 | 11/12/2026 |
| 10.2.1-preview.149 | 54 | 11/14/2026 |
| 10.2.1-preview.148 | 58 | 11/14/2026 |
| 10.2.0 | 90 | 11/13/2026 |
| 10.2.0-preview.147 | 51 | 11/13/2026 |
| 10.2.0-preview.146 | 52 | 11/13/2026 |
| 10.2.0-preview.145 | 57 | 11/12/2026 |
| 10.2.0-preview.144 | 62 | 11/4/2026 |
| 10.2.0-preview.143 | 65 | 10/28/2026 |
| 10.2.0-preview.142 | 78 | 10/21/2026 |
| 10.2.0-preview.141 | 72 | 10/20/2026 |
See the GitHub releases for version-specific changes.