クリーム色の背景、色付き表示、高コントラスト、大きな文字のほうが読みやすいですか?配色と文字を選ぶと、すべてのページに一度で反映されます。

無料レッスン

冪等性キーとちょうど1回の効果

このレッスンのあとで: 冪等性キーを使って、繰り返されるステップを安全にできる。

60分のレッスンコマンド6件永続実行ラボ:ワークフローをわざと落とし、ジャーナルから再開する

冪等性キーとは何か

冪等性キーとは、要求に付けて送る一意の名前です。受け取る側は、同じ要求が何回届いても1回だけ処理します。これがステップのジャーナルの最後のすき間をふさぎます。効果のあと、行を書く前に落ちる場合です。

カード会社、メールのサービス、メッセージキューは、まさにこのためにキーを受け付けます。ジャーナルとキーがそろうと、効果はちょうど1回になります。

このレッスンが終わると

メモ

冪等性キーを使って、繰り返されるステップを安全にできる。

キーワード

ことばいみ
冪等1回でも何回でも、同じ効果になること
冪等性キー1つの要求の名前。繰り返しを見分けるためのもの
少なくとも1回必ず起きるが、2回以上かもしれないという約束
ちょうど1回0回でも2回でもなく、1回だけ起きる効果
一意制約同じ値の2つ目の行を断るデータベースの決まり

学生が入力するセルは、このプレビューでは空白です。

効果と行のあいだで落ちることがある

エンジンはステップの仕事をしてから、ジャーナルの行を書きます。その2つの瞬間のあいだに、すき間があります。そのすき間でプロセスが落ちると、効果は起きたのに、ジャーナルはそれを知りません。

再開のとき、そのステップの行はないので、エンジンはもう一度動かします。ジャーナルが保証するのは少なくとも1回で、ちょうど1回ではありません。ラボの --crash-inside は、まさにそのすき間で落とします。

キーなしで課金の中で落とす

コマンド
docker exec worker python3 order.py order-8 --fresh --crash-inside charge_card

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

order-8 を再開する

コマンド
docker exec worker python3 order.py order-8

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

order-8 の支払いを数える

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

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

キーが繰り返しを答えに変える

--keyed を付けると、課金はキー order-9:charge_card を持ちます。ラボのカード会社は、キーが一意のテーブルに支払いを置き、ON CONFLICT DO NOTHING で挿入します。

1回目の課金は行を加えます。繰り返しはキーがすでにあると気づき、何も加えず、"repeat": true と答えます。どちらの場合も、ワークフローは同じ結果で先に進みます。

キーつきで課金の中で落とす

コマンド
docker exec worker python3 order.py order-9 --fresh --keyed --crash-inside charge_card

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

キーつきで order-9 を再開する

コマンド
docker exec worker python3 order.py order-9 --keyed

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

order-9 の支払いを数える

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

ここでは表示のみで、実行されません。「ラボを開始」を押すと、自分のラボのターミナルに入力できます。

例:同じクラッシュを2通りで

注文送ったキー再開が受けたもの支払い
order-8なし2回目の課金2
order-9order-9:charge_card重複と示された答え1

学生が入力するセルは、このプレビューでは空白です。

よくある間違い

注意

呼び出すたびに新しい乱数のキーを作る人が多くいます。すると再開は新しいキーを送り、カード会社はもう一度課金します。キーは再実行しても同じでなければなりません。ワークフローとステップから作るか、ジャーナルに残しましょう。

試そう:変わるキー

コード: python
import uuid

taken = {}   # カード会社: キー 1 つにつき支払いは 1 件

def charge(key, amount):
    if key in taken:
        return "重複、何も取らない"
    taken[key] = amount
    return str(amount) + " を課金"

def make_key(order):
    return order + ":charge_card"   # 再実行しても同じ

# ワークフローが課金を送り、落ちて、もう一度送る。
for attempt in [1, 2]:
    print("試行", attempt, charge(make_key("order-3"), 2500))
print("取った支払い:", len(taken))
# make_key が order + str(uuid.uuid4()) を返すようにして、もう一度実行しましょう。

このラボとソースについて: 永続実行ラボ:ワークフローをわざと落とし、ジャーナルから再開する

授業で使いますか?このモジュールを学生に割り当てると、教員用ガイド、自動採点つきの課題、学生ごとのラボを使えます。