体系ガイド · 基礎から応用へ

取消しが届く場所と、後始末の責任を分ける

Eventで取消しの位置を固定し、子タスクの回収、finallyの解放、外へ出た副作用の残存を追います。

この記事をロゲイアに質問する確認問題3問に進むこれまでの誤答を復習する

更新日

この記事の目次
  1. 待つのをやめることと、仕事が止まること
  2. 取消しは協調する境界へ届く
  3. 取得から解放までをtryとfinallyで囲む
  4. 取消したタスクの終了も待つ
  5. 外へ出た副作用には別の照会と回復が要る
  6. 親子の寿命と、例外の行き先を決める
  7. 取得中に取消された場合の所有を追う
  8. 後始末が失敗した場合も結果へ残す
  9. どこへ取消しを入れたか答える課題
  10. この記事をロゲイアに質問する理解を確かめる

待つのをやめることと、仕事が止まること

注文を送った処理へ期限が来たとき、画面が待つのをやめても、注文が相手へ届いていないとは限りません。非同期タスクの取消し、ローカル資源の解放、外部の副作用の取消しは別の出来事です。第3段階のデッドライン伝播を前提に、このガイドでは一つのタスクの寿命と後始末を追います。要求を受け付けた記録や送信済みの記録を、取消し例外が出たからという理由だけで消しません。

Pythonのasyncioを使う小例では、タスクがローカルの接続を所有したと見なす集合と、注文を送ったと見なすリストを別に持ちます。実ネットワークへの送信は行いません。取消しが届いてfinallyで所有を外しても、送信記録は残ることをassertします。模型の業務効果と、実タスクへの取消しを組み合わせた例であり、外部決済が取り消せたという実験ではありません。何が実行され何が模型かを先に宣言します。

取消しは協調する境界へ届く

task.cancelを呼ぶと、対象が適切な中断点へ進んだ際に取消し例外を受ける仕組みを使います。CPUだけの長いループがイベントループへ制御を返さなければ、同じようにすぐ届くとは限りません。取消し要求を出した時刻と、タスクが実際に終了した時刻を区別します。cancelを呼んだだけで、全ての資源が既に返ったと表示しないでください。

掲載例ではawait release.wait()が待機点です。親はacquiredというEventを待ち、子が資源を持ち送信記録も付けた段階を確かめてからcancelします。固定時間のsleepで「そろそろ取得したはず」と推定しません。段階を表すEventと、業務を進めるreleaseを分けるので、試験がどの位置へ取消しを入れたかを再現できます。準備を待つ期限も持ち、想定した段階へ到達しなければ検査を失敗として扱います。

取得から解放までをtryとfinallyで囲む

資源を取得した後、その所有期間をtryで囲み、finallyで解放します。途中のawaitで取消しや別の例外が起きても、同じ解放経路へ進めるようにします。ただし、取得する前の失敗へ同じ解放を呼べば二重解放や存在しない資源の操作になるため、どの時点で所有が成立したかを確認します。今回の集合への追加は取得を表す模型で、その直後から保護範囲を始めます。

後始末自体が非同期の場合は、解放を待つ間にも取消しや期限が関係します。shieldなどで守る案もありますが、対象の処理がいつ終わるか、誰がその完了を待つかを別に設計します。見えない背景タスクへ渡して例外を捨てれば、解放を保証したことにはなりません。今回は同期的な集合からの削除でその複雑さを避け、取得済みの所有を一度だけ外したことを直接assertします。

時点ownedsent
取得前空空
acquired通知時connectionを所有order-7を記録済み
cancel後にawait完了finallyで空へ戻るorder-7は残る

取消したタスクの終了も待つ

コードはtask.cancelの後にawait taskを行い、CancelledErrorをその境界で受け取ります。呼出し元が例外を受け取った時点で、子のfinallyを通過したことと、所有集合が空になったことを検査します。送信記録にはorder-7が残り、task.cancelledも真です。取消しを投げた後、その子を誰も待たずに親だけ終わる例にはしていません。タスクを作ることと、その寿命を回収することを対で扱います。

asyncio.runが短い試験の入口と出口を作ります。コードはPythonの標準ライブラリだけで動き、外部の接続情報を必要としません。出力はタスクの取消し、ローカル所有の解放、送信記録の残存という三条件を示します。外部の注文受付数や、別プロセスの仕事の停止を検査したものではありません。自分のプログラムから観測できた状態と、相手側の状態を一つの成功という表示へ混ぜないようにします。

python
import asyncio
async def main():
    acquired=asyncio.Event();release=asyncio.Event();owned=set();sent=[]
    async def request():
        owned.add('connection')
        try:
            sent.append('order-7');acquired.set();await release.wait()
        finally:owned.remove('connection')
    task=asyncio.create_task(request());await asyncio.wait_for(acquired.wait(),2)
    task.cancel()
    try:await task
    except asyncio.CancelledError:pass
    assert not owned and sent==['order-7'] and task.cancelled()
    print('task cancelled; local connection released; sent order still recorded')
asyncio.run(main())

外へ出た副作用には別の照会と回復が要る

注文を送った後で応答を待つところに取消しが届いた場合、相手が適用したかは不明なことがあります。接続を閉じても、相手の保存済み更新が巻き戻るとは限りません。操作IDで結果を照会する、同じIDで再送する、業務として補償するなど、第3段階の手順へ接続します。ローカルな例外の種類を、業務の確定状態の代用にしないことが大切です。

再試行を別のタスクへ任せる場合も、元の期限、操作ID、未完了の記録をどう引き継ぐかを決めます。毎回新しいIDで注文し直せば、取消しで見えなくなった成功と重なって二重になる可能性があります。finallyはローカルの所有を片付ける場所で、外部で確定した効果を自動的に消す仕組みではありません。何を取り消すことができ、何は結果を確認して扱う必要があるかを、履歴の段階ごとに説明します。

親子の寿命と、例外の行き先を決める

一要求のために複数の子タスクを作る場合、要求が終わるときに子が残ってよいかを決めます。構造化された待合せを使うと、作成した子の寿命や失敗を一つの範囲で扱いやすくなります。ただし、既に外へ送った副作用まで同じ範囲で巻き戻るわけではありません。タスクの寿命の構造と、業務トランザクションの境界を区別します。

CancelledErrorを広く捕まえて何もなかったように続けると、呼出し元が期待した取消しや終了の進行を妨げる場合があります。後始末のために捕まえるなら、対象ライブラリの契約に従って再伝播や状態管理を行います。正常終了、取消し、業務失敗、後始末の失敗を一つの空結果へ変換すると、運用時に何を再試行すべきか分からなくなります。今回の小例は取消しを親で受け、残った記録と資源を明示的に検査して終わります。

取得中に取消された場合の所有を追う

取得を待つ間に取り消された場合、実際に資源が渡ったかどうかを、取得APIの契約に従って判断します。まだ渡っていないなら自分の資源として解放しません。取消しと貸出が競合した場合に誰が返すかも明確である必要があります。取得前と取得後へ同じfinallyを無条件に置くと、未所有のものを返したり、渡った資源を見失ったりする危険があります。

掲載例はownedへの追加を同期的な一段階へして、その直後からtryを始めています。したがって実プールの複雑な取得競合を全て検証したわけではありません。実ライブラリの非同期コンテキスト管理へ移すなら、その入口と出口が保証する範囲を確認します。必要な追加試験は、取消し前に待つ印、取得完了の印、返却の印を持ち、どの段階の要求へ取消しが届いたかを再現できるものにします。例の単純化を、対象APIの保証へ読み替えないでください。

後始末が失敗した場合も結果へ残す

解放の処理自体で例外が出た場合、元の取消しと後始末の失敗をどう報告するかを決めます。何も記録せずに空の正常結果へ変換すると、資源がまだ使われている状態を見落とす可能性があります。業務の結果、取消しの完了、所有の解放を別に観測する理由は、どれか一つだけが成功する場合もあるためです。

後始末に外部通信が必要なら、追加の期限や再試行の責任も生じます。親がもう待たない場合、誰がその処理を監督し、いつ失敗と判断するかを定めます。今回の集合からの削除には外部通信がなく、解放の失敗経路を注入していません。実装の拡張時にはその点を新しい検査へ加え、正常な取消しの実行記録だけで全ての異常な後始末も確認済みとはしません。作った子の寿命と、残った回復仕事の寿命を最後まで追えることが大切です。

どこへ取消しを入れたか答える課題

課題は、接続取得と送信記録の後、応答待ちで取消しを受けた今回の状態を三項目で答えることです。解答は、タスクは取消しとして終了、ローカル接続の所有は解放、送信記録は残存です。送信済みが残るから後始末に失敗した、とは言えません。反対に所有が外れたから相手の効果も消えた、とも言えません。それぞれの状態が別の境界を表します。

追加課題は、取得前、取得直後、送信後、応答受信後に取消し点を置いた場合の期待状態を表にすることです。取得前なら解放すべき所有がない場合があり、送信後なら結果不明の照会が必要になる場合があります。コードの試験ではまずEventの位置を変え、意図した段階へ到達したことを確認してから取消します。sleepの長さを調整して偶然の順序を狙うのではなく、各境界の記録とassertで説明できる構成を保ってください。

読了と問題の結果を、言語ごとにこのブラウザへ保存します。

コースの順番に沿って学ぶ

CS基礎を固める · STEP 17

サーバーの中で起きていること · STEP 7

AI基盤へ進む · STEP 7

学習コースから次を選ぶ