EntityFrameworkCore.DynamoDb 10.2.0-preview.147

This is a prerelease version of EntityFrameworkCore.DynamoDb.
There is a newer version of this package available.
See the version list below for details.
dotnet add package EntityFrameworkCore.DynamoDb --version 10.2.0-preview.147
                    
NuGet\Install-Package EntityFrameworkCore.DynamoDb -Version 10.2.0-preview.147
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="EntityFrameworkCore.DynamoDb" Version="10.2.0-preview.147" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="EntityFrameworkCore.DynamoDb" Version="10.2.0-preview.147" />
                    
Directory.Packages.props
<PackageReference Include="EntityFrameworkCore.DynamoDb" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add EntityFrameworkCore.DynamoDb --version 10.2.0-preview.147
                    
#r "nuget: EntityFrameworkCore.DynamoDb, 10.2.0-preview.147"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package EntityFrameworkCore.DynamoDb@10.2.0-preview.147
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=EntityFrameworkCore.DynamoDb&version=10.2.0-preview.147&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=EntityFrameworkCore.DynamoDb&version=10.2.0-preview.147&prerelease
                    
Install as a Cake Tool

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.
  • SaveChangesAsync is implemented for Added/Modified/Deleted root entities.
  • Synchronous SaveChanges is not supported (DynamoDB API is async-only).
  • LINQ support is partial; use docs/querying/operators.md as 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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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
Loading failed

See the GitHub releases for version-specific changes.