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.

Interview prep for this lesson

Practice these questions aloud after reading—each links to a full structured answer.

Mid PDF Detailed
Data Consistency: Since all services share the same database, it's easier to ensure?
Short answer: data consistency and avoid issues like eventual consistency. Real-world example (ShopNest) ShopNest splits Catalog, Cart, Order, and Payment into services so teams can deploy catalog changes without redeplo…
Mid PDF Detailed
Database Sharding:?
Short answer: Partition the database into smaller, manageable parts (shards) based on a key (e.g., user ID). Each microservice can manage its own shard. Say this in the interview Define — one clear sentence (the short an…
Senior PDF Detailed
Saga Pattern: As mentioned earlier, this is the preferred way to manage distributed?
Short answer: transactions in microservices without locking resources or requiring a distributed transaction manager. Sagas break a transaction into smaller, manageable steps, with each microservice handling its own loca…
Mid PDF Detailed
Circuit Breaker Pattern: As described, this prevents system overloads by stopping?
Short answer: calls to failing services. Real-world example (ShopNest) After payment succeeds, ShopNest publishes OrderPaid . Inventory and Notification services react independently—no giant distributed transaction. Say…
Mid PDF Detailed
Shard by Business Domain: Each service can own its own database, and the data?
Short answer: can be partitioned by business domain. For example, the Order Service might have its own database, and the Customer Service has another one. Say this in the interview Define — one clear sentence (the short…
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