Lässt es sich mit cremefarbenem Papier, einer Tönung, mehr Kontrast oder größerer Schrift besser lesen? Wählen Sie Ihre Farben und Ihre Schrift, einmalig für alle Seiten.

Kostenlose Lektion

Idempotenzschlüssel und Effekte genau einmal

Nach dieser Lektion: Ich kann einen wiederholten Schritt mit einem Idempotenzschlüssel sicher machen.

Lektion, 60 Min.6 BefehleLab zur dauerhaften Ausführung: einen Workflow absichtlich abstürzen lassen und aus seinem Journal fortsetzen

Was ist ein Idempotenzschlüssel?

Ein Idempotenzschlüssel ist ein eindeutiger Name, der mit einer Anfrage mitgeschickt wird. Der Empfänger handelt dann nur einmal, egal wie oft sie ankommt. Er schließt die letzte Lücke eines Schritt-Journals: einen Absturz nach einem Effekt, aber vor seiner Zeile.

Kartenanbieter, Maildienste und Warteschlangen nehmen solche Schlüssel genau aus diesem Grund an. Mit Journal und Schlüssel zusammen geschieht ein Effekt einmal.

Am Ende dieser Lektion

Notiz

Ich kann einen wiederholten Schritt mit einem Idempotenzschlüssel sicher machen.

Schlüsselwörter

BegriffWas er bedeutet
Idempotentmit derselben Wirkung, ob einmal oder vielmals ausgeführt
Idempotenzschlüsselein Name für eine Anfrage, damit Wiederholungen erkannt werden
Mindestens einmaldas Versprechen, dass etwas geschieht, vielleicht öfter als einmal
Genau einmalein Effekt, der ein Mal geschieht, nie null- oder zweimal
Eindeutigkeitsbedingungeine Datenbankregel, die eine zweite Zeile mit demselben Wert ablehnt

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein Absturz kann zwischen Effekt und Zeile fallen

Die Engine führt die Arbeit eines Schritts aus und schreibt dann seine Journalzeile. Zwischen diesen beiden Momenten liegt eine Lücke. Stirbt der Prozess in der Lücke, ist der Effekt geschehen, aber das Journal weiß es nicht.

Beim Fortsetzen gibt es für diesen Schritt keine Zeile, also führt die Engine ihn noch einmal aus. Das Journal liefert mindestens einmal, nicht genau einmal. Die Option --crash-inside im Labor stürzt genau in dieser Lücke ab.

Mitten in der Abbuchung abstürzen, ohne Schlüssel

Befehl
docker exec worker python3 order.py order-8 --fresh --crash-inside charge_card

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

order-8 fortsetzen

Befehl
docker exec worker python3 order.py order-8

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die Zahlungen für order-8 zählen

Befehl
docker exec db psql -U durable -c "SELECT workflow, amount FROM payments WHERE workflow = 'order-8'"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Der Schlüssel macht eine Wiederholung zur Antwort

Mit --keyed trägt die Abbuchung den Schlüssel order-9:charge_card. Der Anbieter im Labor hält Zahlungen in einer Tabelle, in der der Schlüssel eindeutig ist, und fügt mit ON CONFLICT DO NOTHING ein.

Die erste Abbuchung fügt eine Zeile hinzu. Die Wiederholung findet den Schlüssel schon vor, fügt nichts hinzu und antwortet mit "repeat": true. Der Workflow macht in beiden Fällen mit demselben Ergebnis weiter.

Mitten in der Abbuchung abstürzen, mit Schlüssel

Befehl
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_card

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

order-9 mit seinem Schlüssel fortsetzen

Befehl
docker exec worker python3 order.py order-9 --keyed

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Die Zahlungen für order-9 zählen

Befehl
docker exec db psql -U durable -c "SELECT workflow, idem_key, amount FROM payments WHERE workflow = 'order-9'"

Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.

Beispiel: derselbe Absturz, zwei Wege

BestellungGeschickter SchlüsselWas das Fortsetzen bekamZahlungen
order-8keinereine zweite Abbuchung2
order-9order-9:charge_cardeine Antwort mit repeat1

Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.

Ein häufiger Fehler

Warnung

Viele erzeugen bei jedem Aufruf einen neuen zufälligen Schlüssel. Dann schickt das Fortsetzen einen neuen Schlüssel, und der Anbieter bucht noch einmal ab. Ein Schlüssel muss bei jedem neuen Lauf gleich sein: Bauen Sie ihn aus Workflow und Schritt, oder bewahren Sie ihn im Journal auf.

Probieren Sie es: ein Schlüssel, der sich ändert

Code: python
import uuid

genommen = {}   # der Kartenanbieter: eine Zahlung pro Schlüssel

def abbuchen(schluessel, cent):
    if schluessel in genommen:
        return "Wiederholung, nichts genommen"
    genommen[schluessel] = cent
    return "abgebucht " + str(cent)

def schluessel_bauen(bestellung):
    return bestellung + ":charge_card"   # bei jedem neuen Lauf gleich

# Der Workflow schickt die Abbuchung, stürzt ab und schickt sie noch einmal.
for versuch in [1, 2]:
    print("Versuch", versuch, abbuchen(schluessel_bauen("order-3"), 2500))
print("genommene Zahlungen:", len(genommen))
# Lassen Sie schluessel_bauen bestellung + str(uuid.uuid4()) liefern und starten Sie erneut.

Über dieses Lab und seinen Quellcode: Lab zur dauerhaften Ausführung: einen Workflow absichtlich abstürzen lassen und aus seinem Journal fortsetzen

Sie unterrichten eine Gruppe? Weisen Sie dieses Modul Ihren Studierenden zu, mit Handbuch für Lehrende, automatisch geprüften Aufgaben und einem Lab für jede Person.