Article

Qu’est-ce que CQRS ? Commande, requête et projection

CQRS sépare les décisions métier des lectures. Une réservation d’hôtel montre le rôle des commandes, des requêtes et des projections de données.

Vous enrichissez les résultats de recherche d’un hôtel avec des photos, et chaque modification touche aussi le code qui réserve les chambres. CQRS, pour Command Query Responsibility Segregation, sépare ces deux responsabilités : une commande demande un changement, que le modèle d’écriture accepte ou refuse selon les règles métier ; une requête demande une information, que le modèle de lecture restitue sans modifier les données. Les deux modèles peuvent s’appuyer sur une seule base. Une copie préparée pour la lecture, tenue à jour par une projection, ne s’ajoute que pour un besoin précis, et il faut alors la mettre à jour et pouvoir la reconstruire.

L’exemple suit une chambre fictive, CH-17, dans un code où la recherche et la réservation partagent le même objet, puis sépare ces deux usages en deux modèles. Deux clients tentent ensuite de réserver les mêmes nuits, ce qui montre lequel des deux modèles décide. Enfin, la recherche réclame un index séparé, et la projection apparaît avec ce qu’elle coûte.

Un même objet sert à chercher et à réserver

Prenons une application fictive qui vend des séjours. Son objet Chambre contient le descriptif commercial, une liste de réservations et une propriété disponible. L’écran de recherche demande cet objet pour chaque résultat. Le traitement de réservation reçoit le même objet, modifie sa disponibilité et le sauvegarde.

Exemple fictif — modèle partagé qui devient gênant
Chambre {
  id, nomHotel, photos, equipements, avis,
  disponible, prixAffiche, reservations
}

rechercher(dates) → liste de Chambre
reserver(chambreRecueDeLEcran) → sauvegarde de Chambre

Ce partage pose une première difficulté à la prochaine évolution : le descriptif s’enrichit de photos et d’avis dont la réservation n’a pas besoin, et chaque ajout passe par l’objet que la réservation sauvegarde. La seconde est plus grave. « Disponible » n’a de sens que pour des dates précises : une chambre libre du 10 au 12 novembre ne l’est pas nécessairement du 11 au 13. Le booléen affiché répond donc à une recherche, à l’instant où elle a été faite ; il n’autorise pas à vendre la chambre.

Changez d’abord la dernière ligne du code. L’écran y renvoie au serveur un objet d’affichage, que le serveur sauvegarde comme s’il décrivait l’état réel des réservations. Le client choisirait ainsi lui-même ce que le serveur enregistre. Le serveur doit plutôt recevoir une intention, « réserver CH-17 du 10 au 12 novembre », et la vérifier sur l’état actuel des réservations.

La commande porte une intention, la requête une réponse

CQRS donne un nom à chacun de ces deux usages. Une demande de changement, comme « réserver cette chambre pour ces nuits », est une commande. Le modèle d’écriture, souvent appelé write model, la reçoit et décide de l’accepter ou de la refuser avec une explication. Il conserve les données qui font référence pour le domaine : ici, les réservations. Une demande d’information, comme « quelles chambres sont libres du 10 au 12 novembre ? », est une requête. Le modèle de lecture, ou read model, y répond sans modifier l’état métier.

Dans l’hôtel, chacun reçoit son propre contrat :

Exemples de contrats, pas une bibliothèque à exécuter

ReserverChambre {
  chambreId: "CH-17",
  arrivee: "2026-11-10",
  depart: "2026-11-12",
  offreId: "OFF-83"
}

ResultatRecherche {
  chambreId: "CH-17",
  nomHotel: "Les Tilleuls",
  photo: "/photos/ch17",
  equipements: ["bureau", "douche"],
  prixIndicatifEUR: 240,
  disponiblePour: ["2026-11-10", "2026-11-12"]
}

La commande ne contient ni la liste des réservations ni le prix. Le client ne peut donc pas remplacer les réservations existantes, ni fixer son tarif en envoyant une valeur depuis l’écran. Il désigne la chambre, les dates et l’offre choisie, et le service vérifie l’offre, les dates et le droit du client à réserver.

La réponse de recherche, au contraire, peut regrouper des données de plusieurs tables et calculer des libellés pour l’écran. Ajouter une photo modifie ce contrat de lecture sans entrer dans la règle qui protège les chambres.

Les règles qui doivent toujours être respectées sont appelées invariants. Pour l’hôtel, une nuit d’une chambre ne peut être vendue qu’une fois. Le modèle d’écriture protège ces règles, y compris lorsque deux clients agissent au même moment.

Modèle d’écritureModèle de lecture
BesoinAccepter ou refuser une modificationPrésenter les informations demandées
ExempleVérifier qu’une réservation ne chevauche aucune autreAfficher les chambres libres avec leurs photos
OrganisationAdaptée aux règles métierAdaptée aux recherches et aux écrans
StockageConserve les données de référencePeut lire ces données ou une copie préparée

Le sigle se traduit par « séparation des responsabilités entre commandes et requêtes ». Greg Young rattache cette approche au principe de séparation commande/requête de Bertrand Meyer. Dans une API, le résultat d’une commande peut inclure une confirmation, un identifiant ou une erreur : la réservation de CH-17 renvoie son numéro, ou la raison de son refus. Le point à préserver est la distinction des responsabilités : une requête de consultation ne doit pas déclencher discrètement une modification métier.

Le changement de code peut rester modeste : un traitement ReserverChambre utilise le modèle métier, tandis qu’une requête SQL produit directement ResultatRecherche. À l’inverse, ranger le code dans deux dossiers « commandes » et « requêtes » ne sépare rien si l’écran continue de fournir au serveur l’état métier à sauvegarder.

Deux clients, une seule chambre : le modèle d’écriture départage

Supposons que deux recherches aient affiché CH-17 libre du 10 au 12 novembre. Alice et Bilal confirment ensuite les mêmes nuits. Séparer les modèles ne désigne pas de gagnant : le traitement d’écriture doit départager les deux demandes, et il lui faut pour cela une protection contre la concurrence.

Une réalisation possible, simplifiée pour cet exemple, représente chaque nuit vendable par une ligne unique (chambreId, date), créée à l’avance, avant toute réservation. La date de départ est exclue : un séjour du 10 au 12 occupe les nuits du 10 et du 11. La transaction verrouille les lignes des nuits demandées, qui le restent jusqu’à sa fin, vérifie qu’elles sont libres, puis inscrit la réservation. Elle les verrouille toujours dans le même ordre, par date croissante. Sans cette précaution, deux réservations qui se recouvrent pourraient attendre chacune une nuit déjà verrouillée par l’autre, une impasse appelée interblocage ; la documentation de PostgreSQL (§13.3.4) présente cet ordre constant comme la meilleure défense contre elle.

ÉtapeAliceBilal
RechercheVoit deux nuits libresVoit les mêmes nuits libres
TraitementVerrouille les nuits, puis les attribueAttend l’accès aux lignes concernées
Après validation d’AliceReçoit une réservation confirméeRelit les nuits occupées et reçoit un refus

Le refus de Bilal est correct, même si son écran affiche encore « disponible » : l’état des nuits a changé entre sa recherche et sa confirmation. L’application doit lui expliquer ce refus et lui proposer une nouvelle recherche, sans lui laisser croire que l’affichage valait réservation.

D’autres mécanismes protègent la même règle : selon la base, une contrainte d’exclusion sur des intervalles de dates ou une écriture conditionnelle, avec des attentes et des reprises propres à chaque moteur. Quel que soit le mécanisme, il faut vérifier qu’aucune réservation chevauchante n’est acceptée quand deux demandes arrivent ensemble ; la présence du sigle CQRS dans l’architecture ne le garantit pas. L’article sur le modèle d’écriture développe cette responsabilité, avec une mise à jour conditionnelle sous PostgreSQL et la boîte d’envoi évoquée plus bas.

Une seule base suffit pour commencer

Jusqu’ici, la recherche et la réservation consultent le même stockage. La requête de lecture assemble les tables dont l’écran a besoin ; le traitement de réservation modifie les tables qui font référence. Une recherche lancée après la confirmation d’Alice lit donc l’état confirmé, à condition d’interroger la base principale dans une nouvelle transaction, sans passer par un cache ou une réplique en retard. Aucun bus de messages ni serveur supplémentaire n’a été nécessaire : Oskar Dudycz insiste sur cette possibilité de séparer les modèles sans imposer ni messagerie ni bases distinctes.

Martin Fowler décrit cette forme de CQRS, dans laquelle les deux modèles partagent la même base, qui sert alors de lien entre eux. Le guide CQRS de Microsoft la distingue d’une organisation qui emploie des stockages séparés pour la lecture et pour l’écriture. Ce second choix peut répondre à des besoins de recherche ou de charge différents, mais il ajoute une synchronisation et un retard à gérer. Il faut pouvoir nommer le problème que ces composants supplémentaires résolvent.

Quand la recherche réclame un index, la projection apparaît

Supposons maintenant que la recherche s’enrichisse : texte libre, localisation, filtres sur de nombreux équipements. Un index spécialisé, distinct de la base des réservations, peut alors devenir utile. Le modèle de réservation conserve son autorité ; l’index devient une copie préparée pour ces recherches.

Cette copie doit suivre les changements. Le traitement qui la met à jour s’appelle une projection : il transforme les données de référence en une forme adaptée à la lecture. Quand Alice réserve CH-17, la projection retire les nuits du 10 et du 11 des disponibilités de l’index. Elle écrit donc dans l’index, tandis que le modèle d’écriture lit les réservations pour décider : la séparation porte sur les responsabilités, décider ou restituer, et non sur le type d’opération en base. Une vue conservée dans la même base que les réservations pourrait être mise à jour dans la transaction même de la réservation. L’index externe retenu ici ne participe pas à cette transaction : ses changements lui sont reportés après la validation, comme le montre le schéma suivant.

La réservation de CH-17 est acceptée ou refusée par le modèle d’écriture. Une projection différée alimente l’index de recherche du modèle de lecture, qui peut être en retard.
Dans cet exemple asynchrone, une projection reporte les changements vers le modèle de lecture. CQRS peut aussi utiliser une mise à jour synchrone ou un stockage partagé.

Une mise à jour différée crée un décalage possible : la réservation d’Alice est confirmée dans le modèle d’écriture, mais l’index propose encore CH-17 pour ces nuits. Si les mises à jour finissent par être appliquées, dans le bon ordre et sans réappliquer un état ancien, la copie rejoint l’état de référence. C’est le principe de la cohérence éventuelle. Pendant ce délai, un autre client peut voir CH-17 libre et la demander. Il reçoit alors le même refus que Bilal, parce que le modèle d’écriture vérifie les nuits sur les réservations, quel que soit l’affichage. L’article sur le théorème CAP permet d’approfondir les choix de cohérence lorsque des données sont partagées entre machines ; cette complexité n’est pas un passage obligé pour commencer à séparer commandes et requêtes.

Une copie séparée demande de livrer chaque changement et de pouvoir la refaire

La mise à jour différée ouvre une autre fenêtre : si le serveur confirme la réservation puis s’arrête avant de transmettre le changement, l’index risque de ne jamais l’apprendre. Le guide de Microsoft recommande pour ce cas la boîte d’envoi transactionnelle (transactional outbox) : le changement à transmettre est enregistré dans la même transaction que la réservation, puis un processus de fond le livre à l’index jusqu’à réussite. Le même guide demande que le côté lecture tolère les livraisons en double. Ici, la projection fixe l’état des nuits au lieu de décrémenter un compteur : marquer deux fois le 10 et le 11 comme occupés donne le même index qu’une seule fois, ce qui rend cette mise à jour idempotente.

La répétition n’est pas le seul risque. Supposons qu’Alice annule sa réservation, puis que l’ancienne livraison « nuits occupées » soit rejouée après l’annulation : l’index marquerait de nouveau CH-17 occupée. La projection doit donc appliquer les changements d’une même chambre dans leur ordre, ou refuser un changement plus ancien que celui qu’elle a déjà appliqué, par exemple en comparant un numéro de version porté par chaque changement. Chris Richardson compte d’ailleurs l’ordre d’envoi parmi les exigences de la boîte d’envoi, à côté du traitement des doublons.

Il faut aussi pouvoir refaire l’index après une erreur de projection ou un changement de format. Une projection peut être reconstruite si les informations nécessaires à son calcul sont conservées ailleurs. Pour les disponibilités actuelles de CH-17, l’état courant des réservations suffit ; pour savoir combien de fois la chambre a été réservée puis annulée au cours du mois, il faut aussi un historique. Une information qui n’existerait que dans l’index serait perdue avec lui. Gardez aussi un moyen de réconcilier l’index avec les réservations : comparer son contenu à leur état courant pour réparer les écarts. Refaire l’index ne doit pas rejouer les effets métier, comme l’envoi des confirmations aux clients.

Le besoin de retrouver l’histoire des modifications ou l’état à une date peut conduire à l’event sourcing. Dans ce choix de stockage, la suite des événements enregistrés fait référence, comme source de vérité, et l’état se reconstitue en les rejouant, comme le décrit Martin Fowler. Garder un historique à côté de l’état courant ne constitue pas, à lui seul, ce choix. CQRS ne l’impose pas : le besoin d’historique ou d’état à une date se décide séparément, et séparer la réservation de sa vue de recherche ne suffit pas à le rendre nécessaire.

Trois changements éprouvent la séparation

Revenons aux photos du début, qui obligeaient à toucher au code de réservation. Trois modifications permettent d’éprouver la conception sans invoquer un gain abstrait. Ajouter une photo modifie ResultatRecherche et laisse intacte la règle de réservation. Ajouter une restriction sur les séjours, par exemple deux nuits minimum le samedi, modifie le traitement qui décide, sans que chaque écran ait à reproduire cette règle. Refaire l’index préserve les réservations et n’envoie pas une seconde fois les confirmations déjà émises.

Ces épreuves supposent des règles à protéger. Un petit annuaire réduit à du CRUD, qui crée, lit, modifie et supprime des fiches sans règle métier supplémentaire, reste hors de ce besoin. Il ne suffit pas d’avoir des boutons « créer » et « rechercher » pour justifier une nouvelle architecture.

Martin Fowler réserve CQRS à des parties précises d’un système, jamais au système entier, et juge que pour la plupart des systèmes il ajoute une complexité risquée. La première limite tient : CQRS s’applique à l’intérieur d’un domaine, comme la réservation de l’hôtel, et non comme architecture de tout le système. La position défendue ici s’écarte de la seconde dans les architectures découpées en domaines, qu’il s’agisse d’un monolithe modulaire, une application déployée d’un seul tenant mais organisée en modules responsables de leurs données, ou d’un système distribué. La pratique retenue y structure systématiquement chaque domaine avec CQRS, d’abord comme cadre d’organisation du code et du domaine, plus que comme optimisation technique. Sans cette séparation, des contraintes que le système subit de toute façon restent implicites : le retard d’une copie et sa réconciliation, que l’hôtel a montrés, et, entre plusieurs domaines ou machines, les partitions réseau, ces coupures de communication entre machines, et les compensations, ces actions métier qui corrigent une étape déjà faite. La décision à justifier ensuite concerne un index ou un stockage distinct pour les lectures.

Pour le domaine de réservation de cet hôtel, le choix par défaut garde la commande de réservation et la vue de recherche distinctes, sur le même stockage. Une recherche plus riche pourrait ensuite justifier l’index spécialisé ; si sa propagation demandait plus de travail que la recherche n’en économise, la base commune conserverait l’avantage, avec ces deux responsabilités toujours séparées.

Si vous voulez poser ce cadre sur un système existant, vous pouvez demander à Arcate un cadrage de mise en place de CQRS, en précisant les règles métier et les contraintes à conserver.

Sources

Explorer

Sur le même sujet

Choisis dans l’index d’après les étiquettes de cet article — les plus proches d’abord, hors de sa série. Rien n’est écrit à la main : un article publié demain avec les mêmes étiquettes y prendra place.

Laisser un commentaire

Elle n'est jamais affichée ni publiée. Elle sert à regrouper vos commentaires et, si vous vous inscrivez un jour avec elle, à vous les rendre.

Votre commentaire sera relu avant d'être publié.