冪等性キーとは何か
冪等性キーとは、要求に付けて送る一意の名前です。受け取る側は、同じ要求が何回届いても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-9 | order-9:charge_card | 重複と示された答え | 1 |
学生が入力するセルは、このプレビューでは空白です。
よくある間違い
注意
呼び出すたびに新しい乱数のキーを作る人が多くいます。すると再開は新しいキーを送り、カード会社はもう一度課金します。キーは再実行しても同じでなければなりません。ワークフローとステップから作るか、ジャーナルに残しましょう。
試そう:変わるキー
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()) を返すようにして、もう一度実行しましょう。