EntityFrameworkCore.DynamoDb

Entity Framework Core provider for AWS DynamoDB.

This provider translates LINQ queries to PartiQL and executes them with the AWS SDK.

Install

dotnet add package EntityFrameworkCore.DynamoDb

Quick Start

1. Configure the provider in your DbContext via UseDynamo(...); see Configuration.
2. Map your entities to DynamoDB tables and key schema; see Indexes.
3. Start with supported LINQ operators from Operators.
4. Review Limitations before adopting query patterns.

Current Scope

• Async query execution is supported.
• SaveChangesAsync is implemented for Added/Modified/Deleted root entities.
• Synchronous SaveChanges is not supported (DynamoDB API is async-only).
• LINQ translation support is partial; Operators is the source of truth.
• Includes support for table mapping, key mapping, owned types, and secondary-index metadata.

Compatibility

• .NET target framework: net10.0
• EF Core version: 10.0.x
• AWS SDK dependency: AWSSDK.DynamoDBv2 4.x
• Works with Amazon DynamoDB and DynamoDB Local.

Issues and Help

• Report bugs and request features on GitHub Issues.
• For local debugging guidance, use Diagnostics.

Documentation

• Configuration
• Indexes
• Architecture
• Concurrency
• Operators
• Pagination
• Projections
• Owned Types
• Diagnostics
• Limitations
• Repository README

Notes

• SaveChangesAsync supports Added/Modified/Deleted root writes, including owned/nested mutations, and follows EF Core AutoTransactionBehavior for execution policy (WhenNeeded/Always transactional for multi-root, Never non-atomic batched for multi-root).