Tutorials Microservices with .NET
Shared Database Anti-Pattern — Complete Guide
Shared Database Anti-Pattern — Complete Guide: free step-by-step lesson with examples, common mistakes, and interview tips — part of Microservices with .NET on Toolliyo Academy.
On this page
Microservices with .NET · Lesson 10 of 131
Shared Database Anti-Pattern
Beginner → Intermediate → Advanced → Professional
Beginner · 1 — Foundations · ~6 min · Module 1: Foundations and Fundamentals
What is this?
Shared database anti-pattern is when multiple services read and write the same tables. It looks convenient but creates a distributed monolith — everyone blocks everyone on schema changes.
Why should you care?
Teams think they are doing microservices because they have two APIs. If both APIs hit Orders table directly, you still have one brain — just two mouths.
See it live — copy this example
Create a Web API project (dotnet new webapi), paste the code, then run dotnet run.
// ❌ ANTI-PATTERN — Payment.Api writes Orders table
public async Task MarkPaid(Guid orderId)
{
var order = await _sharedDb.Orders.FindAsync(orderId);
order.Status = "Paid"; // Order team did not own this change!
await _sharedDb.SaveChangesAsync();
}
// ✅ Order service owns order status — Payment publishes event
await _bus.Publish(new PaymentSucceededEvent(orderId, transactionId));
Run Example »
Edit the code and click Run — like W3Schools Try it Yourself.
What happened?
- Payment tells the world payment succeeded.
- Order service listens and updates its own database.
- Payment never touches Order tables.
Try it yourself
- List tables each service should own on paper.
- If two services need the same table today, pick one owner.
- Other service gets read-only API or event copy — not direct SQL.
- Change a string or route in the example and save — watch Swagger or the RabbitMQ Management UI update.
- Break the code on purpose (remove a semicolon), read the error message, then fix it.
Remember
Two services, one database = anti-pattern for independent deploy. Pick an owner for each table. Integrate with events or HTTP, not shared writes.
Real-world: Schema migration deadlock
Order team adds NOT NULL column; Payment nightly job breaks because it still inserts old shape. Shared DB means one team emergency on Friday night.
Outcome: Payment deploy never waits on Order migration window.
Sign in to ask a question or upvote helpful answers.
No questions yet — be the first to ask!