Article

Sagas : coordonner plusieurs opérations et gérer leurs échecs

Réserver un vol puis un hôtel peut échouer à mi-parcours. Une saga organise les étapes, leur reprise et les compensations pour terminer le traitement.

Prenons un voyage fictif : Nadia réserve un vol, puis un hôtel. Le vol est réservé, mais l’hôtel répond « complet ». Le système doit alors trouver une autre chambre ou annuler la réservation du vol, et l’hôtel aurait aussi pu ne pas répondre du tout. Quand les étapes d’un parcours appartiennent à des services qui ne partagent pas de transaction, une saga les organise : chaque étape valide son propre changement, et si une étape échoue, des actions de compensation corrigent celles qui ont déjà réussi. Elle ne rend pas le parcours atomique, mais elle organise sa progression vers une issue connue, avec une intervention humaine quand un service reste indisponible.

Le voyage de Nadia sert d’exemple d’un bout à l’autre : d’abord ce qu’une transaction ne peut pas couvrir ici, puis la saga et sa compensation ; ensuite les deux façons d’enchaîner les étapes, la réponse qui n’arrive pas, et enfin ce que le coordinateur du voyage doit conserver pour ne pas déclarer la fin trop tôt.

Une transaction ne couvre pas le vol et l’hôtel

Une transaction de base de données regroupe plusieurs changements : ils sont validés ensemble, ou aucun ne l’est. Si les deux réservations étaient entièrement décidées et enregistrées dans une même base, sans engagement pris ailleurs hors de cette transaction, une transaction locale courte suffirait : en cas d’échec de l’hôtel, la base annulerait aussi le vol, et aucune lecture protégée par le niveau d’isolation choisi n’aurait vu le vol réservé seul. Deux réservations prises dans deux systèmes, puis recopiées dans une base locale, ne remplissent pas cette condition. Quand c’est possible, cette solution reste la plus simple : commencez par elle. La transaction qui protège une décision dans un service est détaillée dans un autre article.

Ici, le vol et la chambre appartiennent à deux services, chacun avec sa base et ses règles. Dans le vocabulaire de CQRS, chacun possède son modèle d’écriture, qui décide seul sur ses données ; la décision « voyage confirmé » traverse donc plusieurs modèles. Les transactions distribuées, qui font valider ensemble des changements dans plusieurs bases, existent, mais tous les services ne les prennent pas en charge ; dans l’exemple, l’API du service des vols n’en propose pas. Elles ajoutent aussi des contraintes de coordination et de disponibilité, dont le coût s’évalue dans le contexte réel. Il n’est pas utile de les déclarer impossibles dans tous les cas ; pour le voyage de Nadia, elles ne sont pas disponibles.

Une saga enchaîne des décisions locales

Dans une saga, chaque étape valide son propre changement dans une transaction locale. Le service des vols réserve une place ; celui des hôtels réserve une chambre ; dans le parcours complet, le paiement vient ensuite. Aucune validation unique ne rend l’ensemble définitif en une fois. Entre deux étapes, le voyage est dans un état intermédiaire, par exemple « vol réservé, hôtel en attente ».

Hector Garcia-Molina et Kenneth Salem ont décrit le mécanisme en 1987, dans Sagas, pour découper des transactions de longue durée en transactions plus courtes. Leur saga donne une garantie précise : soit toutes ses transactions aboutissent, soit des transactions de compensation sont exécutées pour corriger l’exécution partielle. Son utilisation entre services autonomes est une application courante de cette idée ; Chris Richardson la décrit comme une suite coordonnée de transactions locales.

Une compensation est une nouvelle action métier

Revenons à l’hôtel complet. La réservation du vol a déjà été validée par le service des vols ; aucune transaction globale n’existe qu’il suffirait d’annuler. Le système demande donc au service des vols une nouvelle opération : annuler cette réservation. Jim Gray l’écrivait dès 1981 dans The Transaction Concept : une fois une transaction validée, seules d’autres transactions peuvent en modifier les effets, et il appelle ces transactions après coup des transactions de compensation.

Le vol F7 est réservé, mais l’hôtel H7 répond complet. Le paiement n’est pas atteint ; l’annulation A7 du vol est une nouvelle action à suivre, avec frais ou intervention possibles. Un délai dépassé demande de rechercher le résultat.
Après le vol réservé, le refus de l’hôtel interrompt la suite du parcours. La compensation demande une nouvelle action, annuler le vol, dont le résultat doit être suivi.

La compensation contrebalance un effet précédent sans effacer son existence. L’historique du vol peut donc montrer « réservé », puis « annulé ». Un remboursement suit le même principe : le paiement initial reste un fait. Richardson le résume par l’absence de retour arrière automatique : les développeurs doivent concevoir les compensations qui défont explicitement les changements des étapes précédentes.

Tous les effets ne sont pas entièrement compensables. Une réservation non remboursable peut laisser des frais ; un courriel envoyé ne peut pas être retiré de la boîte de son destinataire. Le métier doit définir le résultat acceptable, et les cas qui exigent une intervention humaine.

Les autres traitements voient l’état intermédiaire

Puisque chaque étape est validée aussitôt, d’autres traitements peuvent voir le voyage de Nadia à mi-parcours. Garcia-Molina et Salem le notaient déjà : d’autres transactions peuvent voir les effets d’une saga partiellement exécutée. Une saga ne fournit donc pas l’isolation d’une transaction unique, et Richardson range ce manque d’isolation parmi ses inconvénients : des sagas et des transactions concurrentes peuvent produire des anomalies dans les données.

Les opérations concurrentes demandent alors des règles explicites, que Richardson appelle des contre-mesures. Une réservation temporaire peut protéger la place de Nadia pendant le parcours, avec une date d’expiration ; certaines modifications du voyage peuvent être interdites tant qu’il n’est pas confirmé. Ces règles appartiennent aux services concernés : la durée et les conditions d’une réservation temporaire se négocient avec le service des vols, et le parcours ne peut pas inventer cette garantie.

Choisir qui enchaîne les étapes

Quelqu’un doit déclencher la demande d’hôtel après le vol, et l’annulation du vol après le refus de l’hôtel. En chorégraphie, chaque participant réagit aux événements des autres : l’annonce « vol réservé » déclenche, par exemple, la recherche d’une chambre. En orchestration, un coordinateur suit l’avancement et demande les étapes suivantes ; il sait, par exemple, qu’il attend une réponse de l’hôtel avant de poursuivre.

ApprocheIntérêtPoint d'attention
ChorégraphieChaque participant réagit de façon autonome.Le parcours complet devient difficile à suivre si les réactions se multiplient.
OrchestrationL’enchaînement et les attentes sont décrits dans un même déroulement explicite.Le coordinateur doit conserver son avancement et reprendre après une panne.

Privilégiez l’orchestration lorsque le parcours comporte de nombreuses branches, des délais ou des interventions humaines. Pour quelques réactions indépendantes, la chorégraphie peut suffire. Le voyage de Nadia a des attentes, une compensation et des frais possibles : le choix retenu pour ce parcours est l’orchestration, et la suite de l’article suit son coordinateur.

Un refus n’est pas une réponse perdue

Un hôtel qui répond « complet » a refusé la réservation. Un appel qui expire ne permet pas de conclure : la chambre peut avoir été réservée sans que la réponse soit arrivée. Annuler le vol à ce moment pourrait laisser Nadia avec une chambre et sans vol.

Dans ce second cas, le coordinateur recherche l’opération, ou la reprend avec le même identifiant. Pour cela, chaque demande porte un identifiant stable, choisi avant le premier envoi : H7 pour la réservation d’hôtel de Nadia, F7 pour celle du vol. Relancer la réservation avec un nouvel identifiant risquerait de créer une seconde chambre. Avec le même identifiant, le service des hôtels peut reconnaître la répétition et renvoyer le résultat de la première demande, à condition que son contrat garantisse la déduplication pour cette opération et cet identifiant, pendant toute la période où une reprise reste possible. La reprise renvoie aussi le même contenu : H7 réemployé pour une autre chambre ne serait plus la même opération. C’est ce contrat, et non la seule présence d’un champ d’identifiant, qui rend la reprise idempotente, sans effet supplémentaire. La même condition vaut pour l’annulation du vol.

Les compensations peuvent elles aussi échouer temporairement : le service des vols peut être indisponible au moment où le coordinateur demande l’annulation, A7. Elles doivent donc être suivies et reprises comme les autres étapes. Le statut « annulation en cours » est plus exact qu’une réussite annoncée avant d’avoir reçu la confirmation.

Le coordinateur conserve l’avancement et ne déclare pas trop tôt la fin

Pour reprendre après une interruption, le coordinateur stocke son état de façon durable : étapes terminées, demandes envoyées, réponses attendues, compensations engagées. Ce suivi ne remplace pas les données de référence de chaque participant, qui restent seuls à décider. Le statut du voyage reflète les confirmations effectivement reçues, sans promettre un « tout ou rien » que le système ne garantit pas.

Le tableau réunit les situations rencontrées plus haut, et une dernière : l’annulation refusée. Il décrit les transitions attendues pour les deux réservations de V7, le voyage de Nadia, pas une implémentation liée à un moteur particulier. Le paiement, qui suit la confirmation des réservations, n’y figure pas.

ÉtatObservationDécision et nouvel état
Vol demandéF7 confirméeEnregistrer la référence du vol ; demander H7 ; hôtel attendu
Hôtel attenduH7 confirméeRéservations confirmées ; paiement à suivre, hors de ce tableau
Hôtel attenduRefus définitif : completDemander A7 ; annulation du vol attendue
Hôtel attenduDélai dépasséRésultat H7 inconnu ; consulter ou reprendre H7, sans conclure à un refus
Annulation attendueService des vols indisponibleConserver A7 en attente ; reprise bornée et alerte
Annulation attendueA7 confirmée avec frais de 15 €Voyage abandonné ; compensation terminée avec frais
Annulation attendueAnnulation refusée définitivementIntervention nécessaire ; vol toujours engagé

Le coordinateur enregistre l’intention de l’étape suivante en même temps que son changement d’état. S’il tombe juste après le refus de l’hôtel, la reprise retrouve A7 à exécuter ; elle ne redemande pas un autre hôtel par défaut. Une réponse tardive est rattachée à son opération par son identifiant, et une réponse reçue deux fois ne fait pas avancer deux fois la machine.

Fixons, pour ce parcours, cinq minutes de reprise automatique de l’annulation. Au-delà, une équipe prend le dossier avec les références F7 et A7. Ce délai organise l’exploitation ; il n’annule pas le vol. L’interface de Nadia indique « voyage non confirmé, annulation du vol en cours », puis les frais confirmés. Elle ne présente jamais cet état comme un retour intégral à la situation initiale.

Deux responsabilités voisines complètent cette machine sans s’y confondre. L’exécution durable, que fournissent certains moteurs de processus, explique comment reprendre le programme du coordinateur après une panne ; la machine d’états décrit ce qu’il doit décider. La réconciliation rapproche ensuite les états des participants lorsqu’un résultat reste incertain, par exemple quand la recherche de H7 ne permet pas de conclure.

Ce que la saga a garanti à Nadia

Dans le parcours suivi, l’hôtel a refusé H7. Le coordinateur a enregistré ce refus et la demande A7 ensemble, a obtenu l’annulation du vol avec 15 € de frais, puis a classé V7 « voyage abandonné ». Nadia n’a jamais vu son voyage présenté comme confirmé, ni comme annulé sans frais. Sans transaction globale, la saga a enchaîné des décisions locales, corrigé par une nouvelle action celle qui avait réussi, et gardé une trace durable de chaque attente jusqu’à un état final connu.

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é.