Tutorials Microservices with .NET

Database Per Service Pattern — Complete Guide

Database Per Service 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 9 of 131

Database Per Service Pattern

BeginnerIntermediateAdvancedProfessional

Beginner · 1 — Foundations · ~6 min · Module 1: Foundations and Fundamentals

What is this?

Database per service means Order.Api talks only to OrderDb. Payment.Api talks only to PaymentDb. No shared tables between services.

Why should you care?

Shared databases create hidden coupling — change a column and two teams break. Separate databases let each team evolve schema on their schedule.

See it live — copy this example

Create a Web API project (dotnet new webapi), paste the code, then run dotnet run.

// Order.Api/appsettings.json
{
  "ConnectionStrings": {
    "OrderDb": "Server=localhost;Database=ShopNest_Orders;Trusted_Connection=True;"
  }
}

// Program.cs
builder.Services.AddDbContext<OrderDbContext>(o =>
    o.UseSqlServer(builder.Configuration.GetConnectionString("OrderDb")));

Run Example »

Edit the code and click Run — like W3Schools Try it Yourself.

Code
Result

What happened?

  • OrderDbContext maps to ShopNest_Orders database.
  • Payment has its own connection string in Payment.Api — never copy Order connection into Payment.

Try it yourself

  1. Install SQL Server Express or use LocalDB on Windows.
  2. Add EF Core packages to Order.Api.
  3. Create OrderDbContext with Orders table.
  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

One service → one database (logical ownership). No cross-service foreign keys. Duplicate read data when needed — consistency via events later.

Real-world: Payment PCI scope

Card tokens live only in PaymentDb. OrderDb stores paymentId reference — not PAN numbers.

Outcome: Security audits draw a circle around PaymentDb only.

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