ワークフローのサガとは何か
サガとは、各ステップに補償を持つワークフローです。補償とは、そのステップを取り消す操作です。後のステップが失敗すると、サガは終わったステップの補償を、新しいものから順に実行します。
車がもう残っていないとき、旅行の予約が飛行機とホテルを取り消すのは、この仕組みです。3つの予約は、それぞれ別の会社が受けていても取り消せます。
このレッスンが終わると
メモ
失敗したサガが実行すべき補償を計算できる。
キーワード
| ことば | いみ |
|---|---|
| トランザクション | データベースが、すべて行うか何もしないかで行う変更 |
| サガ | 1つが失敗すると、終わったステップを取り消すワークフロー |
| 補償 | 1つのステップを取り消す操作 |
| 新しいものから | ステップが動いた順の逆 |
| 取り消せない | 送ったメールのように、元に戻せないこと |
学生が入力するセルは、このプレビューでは空白です。
3社を1つのトランザクションにできない
1つのデータベースの中なら、トランザクションがいくつもの変更を、すべて行うか何もしないかにします。旅行は、航空会社、ホテル、レンタカー会社で予約します。それぞれが自分のシステムを持ち、どれもほかと一緒のトランザクションには入りません。
だから、予約は一つずつ本当に起きる別のステップです。車で失敗したとき、飛行機とホテルはもう予約済みで、何かが取り消す必要があります。
旅行を丸ごと予約する
docker exec worker python3 saga.py trip-1 --freshここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
車で失敗する旅行を予約する
docker exec worker python3 saga.py trip-2 --fresh --fail-at book_carここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
trip-2 の予約を読む
docker exec db psql -U durable -c "SELECT item, status FROM bookings WHERE workflow = 'trip-2' ORDER BY id"ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
補償もステップの一つ
エンジンは失敗したステップも、その理由とともにジャーナルに書きます。補償はどれもふつうのステップで、自分の行を持ちます。
だから、取り消しの途中で落ちても安全です。次の Run は、車が失敗した直後に trip-3 を落とします。再開は3つの行をリプレイし、失敗に気づき、補償を2つとも実行します。補償が途中で忘れられることはありません。
車の失敗の直後に落とす
docker exec worker python3 saga.py trip-3 --fresh --fail-at book_car --crash-after 3ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
trip-3 を再開して補償へ進む
docker exec worker python3 saga.py trip-3 --fail-at book_carここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。
例:trip-3 のジャーナル
| 連番 | ステップ | 結果 | 書いた実行 |
|---|---|---|---|
| 0 | book_flight | 飛行機を予約 | 1 |
| 1 | book_hotel | ホテルを予約 | 1 |
| 2 | book_car | 失敗:車が残っていない | 1 |
| 3 | cancel_hotel | ホテルを取り消し | 2 |
| 4 | cancel_flight | 飛行機を取り消し | 2 |
学生が入力するセルは、このプレビューでは空白です。
よくある間違い
注意
補償で世界がそのまま元どおりになると思う人が多くいます。送ったメールや印刷した切符は戻せません。補償は返金やおわびのような新しい操作で、補償のないステップもあります。そうしたステップは最後に置きましょう。
試そう:取り消せないステップ
STEPS = [["book_flight", "cancel_flight"],
["book_hotel", "cancel_hotel"],
["send_ticket", None], # 送ったメールは取り消せない
["book_car", "cancel_car"]]
FAILS = "book_car"
done = []
for pair in STEPS:
if pair[0] == FAILS:
print(pair[0], "失敗")
break
print(pair[0], "成功")
done.append(pair)
done.reverse() # 新しいものから
for pair in done:
if pair[1] is None:
print(pair[0], "は取り消せない")
else:
print("補償:", pair[1])
# FAILS = "book_hotel" にして、もう一度実行しましょう。