• Backend i API
  • CQRS bez zbędnej złożoności - kiedy warto go wdrożyć?

CQRS bez zbędnej złożoności - kiedy warto go wdrożyć?

17 listopada 2026

Diagram przedstawia uproszczony mikrousługę CQRS i DDD. Pokazuje, jak zapytania i polecenia są rozdzielone, co to jest CQRS w praktyce.

Lista zamówień ładuje się szybko, ale po kliknięciu „Anuluj” ten sam model danych musi jeszcze obsłużyć walidację, zmianę statusu i historię operacji. CQRS rozdziela odczyt od zapisu, choć nie wymaga od razu dwóch baz danych ani osobnych serwerów. Różnica między prostym podziałem w kodzie a rozbudowaną architekturą potrafi jednak zmienić poziom złożoności całego backendu.

Schemat pokazuje, jak CQRS co to rozdziela operacje zapisu (Command Service) od odczytu (Query Service), usprawniając system.

CQRS oddziela intencje zapisu od potrzeb odczytu

  • Command opisuje zmianę stanu, na przykład anulowanie zamówienia.
  • Query pobiera dane i nie zmienia stanu aplikacji.
  • Osobne modele można wdrożyć, korzystając z jednej bazy danych.
  • Event Sourcing jest odrębnym wzorcem, który można łączyć z CQRS, ale nie trzeba.
  • Próg opłacalności pojawia się wtedy, gdy odczyty i zapisy mają wyraźnie różne wymagania lub reguły domenowe.

W CQRS zapis i odczyt odpowiadają na różne pytania

Wyobraź sobie ekran szczegółów zamówienia. Użytkownik chce zobaczyć nazwę produktu, status, przewidywaną dostawę i kwotę, ale zapis wymaga sprawdzenia płatności, dostępności towaru oraz reguł anulowania. Jeden model danych często nie pasuje równie dobrze do obu zadań.

CQRS, czyli Command Query Responsibility Segregation, dzieli te obowiązki. Command wyraża zamiar zmiany, na przykład „Anuluj zamówienie”, a query prosi o dane, na przykład „Pobierz szczegóły zamówienia”. Polecenie przechodzi przez walidację i reguły biznesowe; zapytanie zwraca dane w formie wygodnej dla ekranu lub API.

Ten podział dotyczy odpowiedzialności, niekoniecznie infrastruktury. Jak opisuje wzorzec CQRS w Azure Architecture Center, można rozdzielić modele odczytu i zapisu, a mimo to korzystać ze wspólnego magazynu danych. Właśnie od tego prostszego wariantu zwykle rozsądnie zacząć.

Osobne modele nie oznaczają automatycznie osobnych baz

W nazwie CQRS łatwo dostrzec obietnicę dużej architektury, ale pierwszy krok może być niewielki: osobne ścieżki kodu do zapisu i odczytu w tej samej aplikacji. Model zapisu pilnuje reguł, a model odczytu zwraca gotowy widok, na przykład wiersz tabeli zamówień z nazwą klienta i statusem.

Dopiero gdy obciążenie lub sposób prezentacji danych tego wymaga, można rozważyć osobne magazyny. Wtedy projekcja, czyli przygotowany do odczytu zestaw danych, musi być aktualizowana po zmianach po stronie zapisu. Zyskujesz swobodę optymalizacji, lecz pojawia się koszt synchronizacji i możliwość krótkiego opóźnienia.

WariantCo jest rozdzieloneCo zyskujeszJaki koszt dochodzi
CRUDOperacje korzystają ze wspólnego modeluMniej elementów do utrzymaniaModel może być niewygodny, gdy reguły zapisu i potrzeby ekranów mocno się różnią
CQRS w jednej bazieModele lub ścieżki zapisu i odczytuCzytelniejsze intencje i niezależne kształtowanie odpowiedziDodatkowe handlery, modele i testy
CQRS z osobnymi magazynamiModele oraz fizyczne źródła danychMożliwość niezależnego skalowania i doboru technologiiSynchronizacja, obsługa opóźnień, ponowień i duplikatów zdarzeń

Moim zdaniem najlepszy pierwszy krok to rozdzielenie logiki bez rozdzielania baz. Jeżeli problem nie znika po takim podziale, dopiero wtedy architektura daje powód, by dodawać kolejne elementy.

Event Sourcing i CQRS rozwiązują różne problemy

W rozmowach o CQRS często pojawia się Event Sourcing, jakby oba terminy oznaczały ten sam zestaw decyzji. Nie oznaczają. CQRS rozdziela modele zapisu i odczytu, natomiast Event Sourcing przechowuje historię zmian jako zdarzenia, z których można odtworzyć stan.

Można wdrożyć CQRS, zapisując bieżący stan w zwykłej relacyjnej bazie. Można też połączyć ten wzorzec z Event Sourcingiem, ale wtedy dochodzą między innymi projekcje, odtwarzanie danych i migracje schematów zdarzeń. Martin Fowler w omówieniu CQRS zwraca uwagę na koszt i ryzyko nadmiernego stosowania tego podejścia.

Prawdę mówiąc, przy prostym formularzu edycji profilu, który zapisuje kilka pól i odczytuje je w podobnej postaci, Event Sourcing zwykle oznaczałby więcej mechaniki niż korzyści. Inaczej wygląda system, w którym trzeba odtworzyć, dlaczego saldo lub status przyjęły daną wartość; wtedy historia zdarzeń może odpowiadać na potrzebę, której sam podział komend i zapytań nie rozwiązuje.

Opóźniony odczyt wymaga świadomego zachowania API

Po zapisie użytkownik klika „Anuluj”, dostaje potwierdzenie, a lista nadal pokazuje „W realizacji”. Taki objaw może wynikać z tego, że widok odczytu aktualizuje się asynchronicznie, a potwierdzenie zapisu nie gwarantuje natychmiastowego odświeżenia projekcji.

SytuacjaPrawdopodobna przyczynaCo zrobić
Po udanym zapisie widok pokazuje stary statusModel odczytu jeszcze się nie zsynchronizowałZwróć wynik komendy i pokaż stan tymczasowy albo odśwież widok po potwierdzeniu projekcji
To samo zdarzenie aktualizujące widok przychodzi ponownieSystem wiadomości ponowił dostarczenieZaprojektuj obsługę zdarzeń tak, by ponowne przetworzenie nie tworzyło błędnego stanu
Zapis w bazie się udał, ale zdarzenie nie dotarło do kolejkiZapis i publikacja zdarzenia nie były atomoweRozważ wzorzec Transactional Outbox, który zapisuje zmianę i zdarzenie w ramach jednej transakcji
Ekran musi pokazać natychmiast aktualną wartośćOpóźniona spójność nie pasuje do tej ścieżkiOdczytaj wynik bezpośrednio po zapisie lub zaprojektuj dla tej operacji synchroniczną ścieżkę

To decyzja produktowa, nie wyłącznie techniczna: czy ekran może przez chwilę pokazywać poprzedni stan? Jeśli nie, trzeba zaprojektować odczyt „po zapisie” zamiast liczyć, że osobny model zdąży się odświeżyć. Dla interfejsu użytecznego UX ta chwila niepewności powinna mieć czytelny komunikat, a nie wyglądać jak utracona akcja.

Wybierz CQRS dopiero wtedy, gdy prosty CRUD zaczyna przeszkadzać

Oddzielenie ma sens, gdy reguły zapisu są bogate, a widoki wymagają wielu różnych zestawień albo ruch odczytowy i zapisowy potrzebują innego skalowania. Jeśli odczyt i zapis korzystają z tych samych danych, a logika sprowadza się do prostego CRUD, zostań przy prostszym rozwiązaniu.

Sytuacja w aplikacjiRozsądny kierunek
Formularz zapisuje kilka pól, a ekran pokazuje je niemal bez zmianPozostań przy CRUD
Zapis wymaga reguł biznesowych, których nie da się czytelnie ująć w prostych aktualizacjachRozdziel obsługę komend od zapytań, początkowo w jednej bazie
Różne ekrany potrzebują innych, kosztownych zestawień tych samych danychRozważ wyspecjalizowane modele odczytu
Odczyt i zapis mają różne profile obciążenia, a pomiary pokazują wąskie gardłoSprawdź sens osobnego skalowania i magazynu dla odczytu

Przed wdrożeniem odpowiedz na trzy pytania: co konkretnie jest trudne w obecnym modelu, jak odczyt ma reagować po zapisie i kto będzie utrzymywać synchronizację? Gdy nie ma jasnej odpowiedzi na pierwsze pytanie, architektoniczny podział może jedynie rozrzucić ten sam problem po większej liczbie klas.

Najbezpieczniej zacząć od jednej ścieżki, nie od przebudowy systemu

Weź jeden przypadek, na przykład anulowanie zamówienia. Zdefiniuj komendę opisującą intencję, umieść reguły walidacji po stronie zapisu, a po stronie odczytu przygotuj dane potrzebne konkretnemu ekranowi. Oddziel modele, zachowaj wspólną bazę i sprawdź, czy kod stał się czytelniejszy.

Jeżeli ta zmiana rozwiązuje problem, nie trzeba od razu wdrażać brokera wiadomości, osobnej bazy ani Event Sourcingu. Gdy zaś prawdziwym kłopotem okaże się opóźnienie aktualizacji widoku lub obciążenie zapytań, kolejne elementy można dodać w odpowiedzi na ten właśnie koszt. Tak CQRS pozostaje narzędziem do porządkowania backendu, a nie celem samym w sobie.

FAQ - Najczęstsze pytania

CQRS warto rozważyć, gdy zapis wymaga rozbudowanych reguł biznesowych, widoki korzystają z różnych zestawień albo odczyt i zapis mają odmienne profile obciążenia. Przy prostym formularzu, który zapisuje kilka pól i pokazuje je niemal bez zmian, CRUD będzie prostszy i tańszy w utrzymaniu.

Nie. Można rozdzielić modele i ścieżki zapisu oraz odczytu, korzystając z jednej bazy danych. Osobne magazyny mają sens dopiero wtedy, gdy potrzebne jest niezależne skalowanie lub inny dobór technologii, ponieważ dochodzą wtedy synchronizacja, opóźnienia, ponowienia i obsługa duplikatów zdarzeń.

Samo potwierdzenie zapisu nie gwarantuje natychmiastowej aktualizacji modelu odczytu. API może zwrócić wynik komendy i pozwolić interfejsowi pokazać stan tymczasowy albo odświeżyć widok po potwierdzeniu projekcji. Jeśli aktualna wartość musi być dostępna od razu, należy odczytać wynik bezpośrednio po zapisie lub zastosować synchroniczną ścieżkę; przy publikowaniu zdarzeń warto też rozważyć Transactional Outbox.

CQRS rozdziela odpowiedzialność za zapis i odczyt, natomiast Event Sourcing przechowuje historię zmian jako zdarzenia, z których odtwarza się stan. CQRS można wdrożyć ze zwykłą relacyjną bazą i bez Event Sourcingu. Połączenie obu wzorców ma sens, gdy trzeba odtworzyć, dlaczego saldo lub status przyjęły konkretną wartość, ale wymaga także projekcji, odtwarzania danych i migracji schematów zdarzeń.
Oceń artykuł

Średnia: 4.0 / 5 · 1 ocena

Tagi

cqrs event sourcing crud projekcje transactional outbox

Udostępnij artykuł

Komentarze (0)
Dodaj komentarz