NoSQL trong ASP.NET không bắt đầu bằng một package NuGet, mà bằng việc bỏ thói quen thiết kế ba bảng chuẩn hóa. Nếu bạn bê nguyên mô hình quan hệ sang MongoDB — mỗi entity một collection, join bằng tay trong code — bạn sẽ nhận lại đúng những bất tiện của SQL nhưng mất luôn tính toàn vẹn giao dịch. Bài này đi qua mô hình document, cách quyết định embed hay reference, rồi hai lựa chọn thực tế trong .NET: MongoDB 8.x với driver 3.13 và LiteDB 5.0.21.
Mục lục
Cập nhật 2026
- .NET 8 và .NET 9 hết hỗ trợ ngày 2026-11-10. Toàn bộ ví dụ dưới đây chạy trên .NET 10 LTS, C# 14; .NET 11 mới ở RC3, chưa GA.
- Server MongoDB 8.x; driver chính thức
MongoDB.Driver3.13 (dòng 3.x, LINQ provider v3 là mặc định). - LiteDB 5.0.21 vẫn là bản ổn định. Đây là lựa chọn niche cho ứng dụng một tiến trình, không phải mặc định cho web scale-out.
- Provider EF Core cho Azure Cosmos DB vẫn tồn tại nhưng nhiều giới hạn. Đừng coi nó là “EF Core chạy trên NoSQL”.
Document model: thiết kế theo truy vấn, không theo entity
Trong CSDL quan hệ, bạn chuẩn hóa trước rồi join sau. Trong document DB, bạn trả lời câu hỏi ngược lại: màn hình này đọc những gì trong một lần? Nếu một đơn hàng luôn được hiển thị cùng các dòng hàng của nó, hãy để chúng nằm trong cùng một document. Một lần đọc, một lần ghi, không join.
Điều đó không có nghĩa là không có schema. Collection không ép cấu trúc, nhưng code C# của bạn ép — và nếu muốn chặn dữ liệu rác từ phía server, MongoDB 8.x vẫn hỗ trợ $jsonSchema validator trên collection. Schema linh hoạt là lý do để migrate dễ hơn, không phải lý do để bỏ qua thiết kế.
Quy tắc embed hay reference mà bạn sẽ dùng hàng ngày:
- Embed khi quan hệ 1:1 hoặc 1:ít, hai phần luôn đọc cùng nhau và phần con không bị truy vấn độc lập. Địa chỉ giao hàng trong đơn hàng là ví dụ kinh điển.
- Reference khi quan hệ nhiều-nhiều, khi hai bên được cập nhật bởi luồng nghiệp vụ khác nhau, hoặc khi bên con phình to không giới hạn (log, comment, lịch sử trạng thái).
- Không bao giờ nhét một mảng có thể dài vô hạn vào document. Giới hạn cứng là 16 MB mỗi document; chạm trần đó thì ứng dụng chết ở tầng ghi, không phải ở tầng đọc.
Hệ quả thứ hai: dữ liệu denormalized sẽ trùng lặp. Trùng lặp không sai, nhưng bạn phải có một nơi chịu trách nhiệm cập nhật bản sao. Thường đó là một background job hoặc một luồng ghi duy nhất, không phải “để sau sửa”.
MongoDB 8.x với MongoDB.Driver 3.13
Driver 3.x vẫn giữ nguyên mô hình cốt lõi: IMongoClient → IMongoDatabase → IMongoCollection<T>. Điểm cần nhớ là MongoClient tự quản lý connection pool, nên nó phải là singleton. Tạo một client mỗi request là cách nhanh nhất để cạn socket.
// File: Program.cs
using MongoDB.Driver;
var mongo = builder.Configuration.GetSection("MongoDb").Get<MongoDbOptions>()!;
builder.Services.AddSingleton<IMongoClient>(_ =>
new MongoClient(mongo.ConnectionString));
builder.Services.AddSingleton(sp =>
sp.GetRequiredService<IMongoClient>().GetDatabase(mongo.DatabaseName));
builder.Services.AddSingleton<OrderRepository>();
Model dùng [BsonId] cho khóa chính và [BsonRepresentation(BsonType.ObjectId)] để giữ ObjectId dưới dạng chuỗi trong C#. Cách này tiện cho JSON API, nhưng bạn phải validate chuỗi đó trước khi truyền vào filter — một ObjectId sai định dạng sẽ ném exception, không trả về rỗng.
// File: Orders/Order.cs
public sealed class Order
{
[BsonId]
[BsonRepresentation(BsonType.ObjectId)]
public string Id { get; set; } = null!;
public string CustomerId { get; set; } = null!;
public List<OrderLine> Lines { get; set; } = [];
public DateTime CreatedAtUtc { get; set; }
}
Repository tối giản, kèm phần tạo index — đây là thứ quyết định hiệu năng nhiều hơn mọi tinh chỉnh khác:
// File: Orders/OrderRepository.cs
public sealed class OrderRepository
{
private readonly IMongoCollection<Order> _orders;
public OrderRepository(IMongoDatabase db)
=> _orders = db.GetCollection<Order>("orders");
public Task EnsureIndexesAsync(CancellationToken ct = default) =>
_orders.Indexes.CreateManyAsync(
[
new CreateIndexModel<Order>(
Builders<Order>.IndexKeys
.Ascending(o => o.CustomerId)
.Descending(o => o.CreatedAtUtc),
new CreateIndexOptions { Name = "customer_created" })
], ct);
public Task<List<Order>> ByCustomerAsync(string customerId, int take, CancellationToken ct) =>
_orders.Find(o => o.CustomerId == customerId)
.SortByDescending(o => o.CreatedAtUtc)
.Limit(take)
.ToListAsync(ct);
}
Chọn index theo thứ tự ESR: Equality trước, Sort sau, Range cuối. Index customer_created ở trên đúng thứ tự đó cho truy vấn “đơn hàng của khách X, mới nhất trước”. Đảo thứ tự field là index vẫn tồn tại nhưng không dùng được cho sort, và bạn sẽ thấy COLLSCAN trong explain().
Một lưu ý về driver 3.x: các filter LINQ được dịch bởi LINQ3 provider. Nếu bạn có biểu thức mà provider không dịch được, nó ném lỗi thay vì âm thầm chạy client-side như thời LINQ2. Đây là hành vi tốt, nhưng nghĩa là nên viết filter bằng Builders<T>.Filter cho các truy vấn phức tạp để kiểm soát chính xác.
Giao dịch: có, nhưng không miễn phí
Multi-document transaction trong MongoDB yêu cầu replica set (hoặc sharded cluster). Một mongod standalone — kiểu bạn hay chạy bằng Docker cho nhanh — sẽ từ chối StartTransaction. Đây là lỗi phổ biến nhất khi thử transaction lần đầu.
// File: Orders/OrderService.cs
public async Task PlaceOrderAsync(Order order, ProductFilter filter,
UpdateDefinition<Stock> decrement, CancellationToken ct)
{
using var session = await _client.StartSessionAsync(ct);
await session.WithTransactionAsync(async (s, token) =>
{
await _orders.InsertOneAsync(s, order, cancellationToken: token);
await _stock.UpdateOneAsync(s, filter, decrement, cancellationToken: token);
return true;
}, cancellationToken: ct);
}
Ba điều cần biết trước khi dựa vào transaction:
- Transaction có giới hạn thời gian (mặc định 60 giây) và giới hạn dung lượng. Đừng bọc một job chạy 10 phút vào đó.
WriteConcernvàReadConcernphải đặt trên transaction, không chỉ trên collection.WriteConcern.WMajority+ snapshot read concern là cấu hình lành mạnh cho nghiệp vụ tiền bạc.- Transaction giải quyết tính nguyên tử, không giải quyết việc thiết kế sai. Nếu bạn cần transaction cho mọi thao tác ghi, mô hình document của bạn đang mô phỏng sai mô hình quan hệ.
Và một điều nữa: MongoDB không phải implementation của IDistributedCache. Đừng viết một MongoDistributedCache để “tận dụng DB sẵn có”. Cache cần TTL ngắn, ghi cực nhanh, eviction rẻ — Redis làm việc đó tốt hơn nhiều. Với .NET 10, HybridCache (Microsoft.Extensions.Caching.Hybrid) là abstraction đúng: L1 in-process, L2 phân tán, chống stampede.
LiteDB 5.0.21: document DB nhúng, một file
LiteDB là một thư viện .NET thuần, không có server, dữ liệu nằm trong một file duy nhất. Nó phù hợp với ứng dụng desktop, một service nội bộ chạy một instance, công cụ CLI, hoặc test tích hợp cần dữ liệu thật mà không muốn dựng container.
// File: Program.cs
using LiteDB;
builder.Services.AddSingleton(_ =>
{
var dir = Path.Combine(builder.Environment.ContentRootPath, "App_Data");
Directory.CreateDirectory(dir);
return new LiteDatabase($"Filename={Path.Combine(dir, "local.db")};Connection=direct");
});
Một LiteDatabase instance là thread-safe và giữ lock trên file. Đăng ký nó singleton là bắt buộc; mở hai instance trên cùng file trong cùng process sẽ gặp lỗi lock, và trên container nhiều replica thì tệ hơn — mỗi replica một file, dữ liệu phân kỳ ngay.
// File: Drafts/DraftStore.cs
using LiteDB;
public sealed class DraftStore
{
private readonly ILiteCollection<Draft> _drafts;
public DraftStore(LiteDatabase db)
{
_drafts = db.GetCollection<Draft>("drafts");
_drafts.EnsureIndex(x => x.UpdatedAtUtc);
_drafts.EnsureIndex(x => x.OwnerId);
}
public List<Draft> Recent(string ownerId, int take = 20) =>
_drafts.Query()
.Where(x => x.OwnerId == ownerId)
.OrderByDescending(x => x.UpdatedAtUtc)
.Limit(take)
.ToList();
public BsonValue Insert(Draft draft) => _drafts.Insert(draft);
}
Giới hạn bạn phải nói rõ với team trước khi chọn LiteDB:
- Một writer. Ghi đồng thời bị serialize bằng lock. Với vài chục request/giây ghi liên tục, đây là điểm nghẽn.
- Không scale-out. Không có replication, không có sharding. Chạy 3 pod sau load balancer là sai kiến trúc.
- Backup là copy file. Phải copy khi không có ghi, hoặc dùng cơ chế checkpoint của LiteDB; copy file đang ghi sẽ ra bản hỏng.
- Truy vấn hẹp. LINQ subset, không có aggregation pipeline, không có full-text search thực sự. Nếu bạn cần “tìm gần đúng”, LiteDB không phải công cụ.
- License MIT — thoải mái về pháp lý, nhưng đừng nhầm với MongoDB (SSPL cho server, driver Apache 2.0).
Điểm mạnh thật của LiteDB là chi phí vận hành bằng không: thêm package, trỏ vào một path, xong. Cho một app desktop đọc/ghi cấu hình, cache dữ liệu tra cứu, hoặc lưu nhật ký cục bộ, đó là lựa chọn hợp lý hơn SQLite LocalDB hay một container Postgres.
EF Core Cosmos provider: đọc kỹ trước khi cam kết
Microsoft.EntityFrameworkCore.Cosmos cho phép dùng DbContext với Azure Cosmos DB for NoSQL. Nhưng nó không phải “EF Core với một backend khác”:
- Không có migrations. Provider dùng
EnsureCreated/CreateDatabaseIfNotExists; schema sống trong code, không trong lịch sử migration. - Quan hệ bị giới hạn: không join như SQL, chủ yếu là owned type nhúng trong cùng document.
Includekhông hoạt động theo cách bạn quen. - LINQ dịch được một tập con. Truy vấn phức tạp, aggregation, group-by thường phải viết bằng SDK Cosmos riêng.
- Không transaction cross-document như Mongo; chi phí tính bằng RU và bạn phải theo dõi nó như một chỉ số hạ tầng.
- Phải khai báo
HasPartitionKeyvàToContainer; partition key sai là bài toán chi phí, không phải bài toán chức năng.
Kết luận thực dụng: nếu bạn đã ở Azure và muốn một đường ngắn, provider đủ cho CRUD đơn giản. Nếu bạn cần mô hình dữ liệu phức tạp, dùng SDK Microsoft.Azure.Cosmos trực tiếp sẽ ít bất ngờ hơn.
Khi nào không nên dùng NoSQL
Đây là phần các bài giới thiệu hay bỏ qua. NoSQL là công cụ theo workload, không phải bước tiến hóa của SQL.
| Tình huống | Nên dùng | Vì sao |
|---|---|---|
| Nghiệp vụ nhiều entity, cần ACID xuyên bảng | PostgreSQL / SQL Server + EF Core 10 | Transaction và rang buộc khóa ngoại là yêu cầu, không phải tùy chọn |
| Báo cáo ad-hoc, join tự do, BI | Relational + read model | Document DB không có optimizer cho join tùy ý |
| Cache, session, rate limit | Redis 8 / HybridCache | Cần TTL, eviction, throughput — không phải durability |
| Dữ liệu một tiến trình, không chia sẻ | LiteDB / SQLite | Không có hạ tầng để vận hành |
| Tìm kiếm toàn văn, relevance | Elasticsearch / PostgreSQL FTS | Đây là bài toán inverted index, không phải lưu trữ |
Và nếu team bạn chưa từng vận hành MongoDB: backup, restore, replica set, index tuning đều là kỹ năng riêng. Một CSDL mới là một ca trực mới. Đừng thêm nó vào hệ thống chỉ vì JSON trông hợp với API.
Hướng tới 2027
.NET 11 GA vào tháng 11/2026 (STS, hỗ trợ hai năm) sẽ mang theo EF Core 11; .NET 12 LTS dự kiến 2027. Về phía MongoDB, driver 3.x đã ổn định và không còn chuyện “phải cài thêm LInq provider”. Việc đáng làm ngay trong năm nay là migrate khỏi .NET 8/9 trước ngày 2026-11-10, không phải đổi database.
Checklist trước khi thêm NoSQL vào dự án
- Viết ra ba truy vấn đọc phổ biến nhất. Nếu chúng cần join ba collection, bạn đang chọn sai mô hình.
- Xác định tần suất ghi và kích thước document tối đa. Mảng không giới hạn là bom hẹn giờ ở 16 MB.
- Tạo index theo ESR ngay từ ngày đầu, và chạy
explain()trên truy vấn thật. - Quyết định transaction boundary trước khi viết code; nếu transaction trải qua nhiều service, đó là bài toán saga, không phải DB.
- Nếu chọn LiteDB, ghi rõ trong README: một instance, một writer, không scale-out.
- Nếu đội chưa có runbook backup/restore, đừng đưa MongoDB vào production.
Đọc tiếp trong series: chọn cơ sở dữ liệu phù hợp để so sánh với SQL Server, PostgreSQL và MySQL; EF Core, Dapper và RepoDB cho lớp truy cập dữ liệu; và cache in-memory vs cache phân tán nếu bạn đang cân nhắc giữa Mongo và Redis cho bài toán đọc nhanh.



