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

BeginnerIntermediateAdvancedProfessional

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.

Code
Result

What happened?

  • Payment tells the world payment succeeded.
  • Order service listens and updates its own database.
  • Payment never touches Order tables.

Try it yourself

  1. List tables each service should own on paper.
  2. If two services need the same table today, pick one owner.
  3. Other service gets read-only API or event copy — not direct SQL.
  4. Change a string or route in the example and save — watch Swagger or the RabbitMQ Management UI update.
  5. 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.

Questions on this lesson 0

Sign in to ask a question or upvote helpful answers.

No questions yet — be the first to ask!

Microservices with .NET
Course syllabus

Microservices with .NET Tutorial

Module 1: Foundations and Fundamentals
Module 2: Building User Microservice
Module 3: ShopNest Services and Integration
Module 4: RabbitMQ and Messaging
Module 5: Saga and Distributed Transactions
Module 6: API Gateway
Module 7: gRPC, CQRS, and GraphQL
Module 8: Resiliency and Fault Tolerance
Module 9: DevOps and Cloud-Native
Module 10: Git and GitHub
Module 11: CI/CD Pipelines
Module 12: Observability and Testing
Module 13: Advanced Topics
Module 14: Real-World Enterprise Projects
Toolliyo Assistant
Ask about tutorials, ebooks, training, pricing, mentor services, and support. I use public site content only—not admin or internal tools.

care@toolliyo.com

Need callback? Share your details