Was ist eine Saga in einem Workflow?
Eine Saga ist ein Workflow, in dem jeder Schritt eine Kompensation hat, eine Aktion, die ihn rückgängig macht. Scheitert ein späterer Schritt, führt die Saga die Kompensationen der fertigen Schritte aus, das Neueste zuerst.
So storniert eine Reisebuchung Flug und Hotel, wenn kein Mietwagen mehr frei ist, obwohl drei verschiedene Firmen die Buchungen angenommen haben.
Am Ende dieser Lektion
Notiz
Ich kann bestimmen, welche Kompensationen eine gescheiterte Saga ausführen muss.
Schlüsselwörter
| Begriff | Was er bedeutet |
|---|---|
| Transaktion | Änderungen, die eine Datenbank ganz oder gar nicht macht |
| Saga | ein Workflow, der seine fertigen Schritte rückgängig macht, wenn einer scheitert |
| Kompensation | eine Aktion, die einen Schritt rückgängig macht |
| Das Neueste zuerst | die umgekehrte Reihenfolge, in der die Schritte liefen |
| Unumkehrbar | nicht rückgängig zu machen, wie eine schon verschickte Mail |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Eine Transaktion umfasst keine drei Firmen
Innerhalb einer Datenbank macht eine Transaktion mehrere Änderungen ganz oder gar nicht. Eine Reise wird bei einer Fluggesellschaft, einem Hotel und einer Autovermietung gebucht. Jede hat ihr eigenes System, und keine tritt einer Transaktion mit den anderen bei.
Also ist jede Buchung ein eigener Schritt, der wirklich geschieht. Scheitert der Mietwagen, sind Flug und Hotel schon gebucht, und etwas muss sie rückgängig machen.
Eine ganze Reise buchen
docker exec worker python3 saga.py trip-1 --freshHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Eine Reise buchen, deren Mietwagen scheitert
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_carHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Die Buchungen von trip-2 lesen
docker exec db psql -U durable -c "SELECT item, status FROM bookings WHERE workflow = 'trip-2' ORDER BY id"Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Auch Kompensationen sind Schritte
Die Engine schreibt den gescheiterten Schritt mit seinem Grund ins Journal. Jede Kompensation ist ein gewöhnlicher Schritt mit eigener Zeile.
Ein Absturz während des Rückgängigmachens ist also sicher. Die nächsten Runs lassen trip-3 direkt nach dem Scheitern des Mietwagens abstürzen. Das Fortsetzen spielt die drei Zeilen ab, sieht den Fehlschlag und führt beide Kompensationen aus. Eine Kompensation wird nie auf halbem Weg vergessen.
Direkt nach dem Scheitern des Mietwagens abstürzen
docker exec worker python3 saga.py trip-3 --fresh --fail-at book_car --crash-after 3Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
trip-3 bis in seine Kompensationen fortsetzen
docker exec worker python3 saga.py trip-3 --fail-at book_carHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Beispiel: das Journal von trip-3
| Nr | Schritt | Ergebnis | Geschrieben in Lauf |
|---|---|---|---|
| 0 | book_flight | Flug gebucht | 1 |
| 1 | book_hotel | Hotel gebucht | 1 |
| 2 | book_car | gescheitert: kein Wagen mehr frei | 1 |
| 3 | cancel_hotel | Hotel storniert | 2 |
| 4 | cancel_flight | Flug storniert | 2 |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein häufiger Fehler
Warnung
Viele glauben, eine Kompensation stelle die Welt genau so wieder her, wie sie war. Sie kann keine Mail zurückholen und kein Ticket entdrucken. Eine Kompensation ist eine neue Aktion, etwa eine Erstattung oder eine Entschuldigung, und manche Schritte haben keine. Setzen Sie diese Schritte ans Ende.
Probieren Sie es: ein Schritt ohne Rückgängig
SCHRITTE = [["book_flight", "cancel_flight"],
["book_hotel", "cancel_hotel"],
["send_ticket", None], # eine Mail lässt sich nicht zurückholen
["book_car", "cancel_car"]]
SCHEITERT = "book_car"
erledigt = []
for paar in SCHRITTE:
if paar[0] == SCHEITERT:
print(paar[0], "gescheitert")
break
print(paar[0], "ok")
erledigt.append(paar)
erledigt.reverse() # das Neueste zuerst
for paar in erledigt:
if paar[1] is None:
print("kein Rückgängig für", paar[0])
else:
print("kompensieren:", paar[1])
# Setzen Sie SCHEITERT = "book_hotel" und starten Sie erneut.