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
| Begriff | Was er bedeutet |
|---|---|
| Idempotent | mit derselben Wirkung, ob einmal oder vielmals ausgeführt |
| Idempotenzschlüssel | ein Name für eine Anfrage, damit Wiederholungen erkannt werden |
| Mindestens einmal | das Versprechen, dass etwas geschieht, vielleicht öfter als einmal |
| Genau einmal | ein Effekt, der ein Mal geschieht, nie null- oder zweimal |
| Eindeutigkeitsbedingung | eine 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
docker exec worker python3 order.py order-8 --fresh --crash-inside charge_cardHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
order-8 fortsetzen
docker exec worker python3 order.py order-8Hier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Die Zahlungen für order-8 zählen
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
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_cardHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
order-9 mit seinem Schlüssel fortsetzen
docker exec worker python3 order.py order-9 --keyedHier angezeigt, nicht ausgeführt. Mit „Lab starten“ geben Sie ihn im Terminal Ihres eigenen Labs ein.
Die Zahlungen für order-9 zählen
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
| Bestellung | Geschickter Schlüssel | Was das Fortsetzen bekam | Zahlungen |
|---|---|---|---|
| order-8 | keiner | eine zweite Abbuchung | 2 |
| order-9 | order-9:charge_card | eine Antwort mit repeat | 1 |
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
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.