ゲーム百科 · 履歴と識別子

イベントIDと冪等性を読む|再送・重複・状態変化の違い

同じIDの再送と、同じ内容の別イベントは異なります。受信回数、一意なイベント数、状態の変化をIDの並びから区別し、冪等性の役割を具体例で確認できます。

約8分で読めますゲームの仕組み
イベントの記録を支えるサーバーとネットワーク機器
イベントの記録を支えるサーバーとネットワーク機器 · Abigor / CC BY-SA 3.0 · 写真クレジット

同じイベントIDがもう一度届いても、出来事がもう一度起きたとは限りません。通信の再試行や再送によって、一つの出来事を示すメッセージが複数回届く場合があります。受信回数と、結果へ反映する出来事の数は分けて数えます。

冪等性は、同じ操作を繰り返したときに重複した効果を生まないようにする性質です。同じ数値が並んでいることや、同じ成功文が表示されることとは別です。イベントID、対象ID、状態、時刻の役割を区別すると、履歴の行数が異なる理由を読み解けます。

同じ出来事と、同じ内容の別の出来事を区別する

重複を調べる際の中心は、文章や数値が似ているかではなく、一つの出来事を識別する値です。金額、状態、時刻が一致していても、それだけで同じイベントと判断できるわけではありません。

記録の例受信した数識別した出来事の数
E-10111
E-101, E-10121
E-101, E-10222

イベントIDは何を識別するか

イベントIDがE-101とE-102なら、たとえ状態欄や数値欄が同じでも、別のイベントとして扱う設計があります。識別子は、そのイベントをほかと区別するための値です。一方、同じE-101が複数回届いた場合は、同じイベントの再送かどうかを調べる手掛かりになります。

ただし、識別子の一意性は名前だけでは保証されません。どの発行元、どの環境、どの期間の範囲で重ならない値なのかという約束が必要です。別のシステムが偶然同じ文字を使う場合には、発行元も合わせた組で読む必要があります。

受付の回数と結果の件数は一致しない

あるイベントを最初に1回受け取り、通信の再試行で同じものを2回受け取れば、受信したメッセージは3件です。それでも実際に表している出来事が一つなら、結果へ反映する単位は1件という設計になります。

受信ログの3行をそのまま処理結果の3件と数えると、同じ出来事を繰り返し含めてしまいます。ログの用途に応じて、受信回数、重複回数、反映済みイベント数を別々の列として見ることが、件数の違いを読み解く助けになります。

同じ数値だけで重複と決めない

同じ時刻に同じ値の記録が2件あっても、異なるラウンドや別の対象に属する場合があります。値が一致することは、同じ出来事を意味する十分な条件ではありません。内容の一致と、識別子で示される同一性を分けて考えます。

逆に、一つのイベントの再送で受信時刻だけが変わることもあります。すべての列が完全一致する行だけを重複として削る方法では、受信時刻の異なる再送を残してしまいます。何を一つとして数えるかという意味の定義が先に必要です。

再送された同じイベントを、二重に数えない
IDの一致だけを扱う簡略例です。実システムでは内容の整合性も照合します。 図は横にスクロールできます。
イベントの記録を支えるサーバーとネットワーク機器
イベントの記録を支えるサーバーとネットワーク機器 · Trique303 / CC BY-SA 4.0 · 写真クレジット

冪等性は、繰り返したときの効果をそろえる性質

冪等性は「べきとうせい」と読みます。同じ操作を同じ条件で繰り返したとき、追加の重複した効果を生まないようにする性質です。応答の文字列が毎回まったく同じかどうかとは分けて考えます。

再試行を一つの論理的な操作へ結び付ける

最初の要求と再試行へ同じ識別キーを付けると、受け付け側は同じ操作の続きを見分ける手掛かりを持てます。キーを毎回変えてしまうと、同じ操作を再送しているのか、新しい操作を追加したのかを区別しにくくなります。

一方、内容の違う新しい操作へ古いキーを使い回すと、前の結果と衝突する場合があります。キーが一致することと、要求の意味が一致することを合わせて確認する設計が必要です。キーは便利な目印ですが、中身の違いを無視する許可にはなりません。

「同じ応答」と「同じ効果」は別

再試行の応答に現在の状態が含まれる設計では、時刻や状態が前回から変わっている場合もあります。それでも新しい重複した出来事を作らず、同じ対象を返しているなら、効果の重複を防ぐという目的を満たす場合があります。

反対に、画面へ同じ成功文が表示されていても、内部で別の対象を毎回作っていれば、効果は繰り返されています。利用者向けの文言だけから、システムの冪等性を判断することはできません。結果の識別子や記録の対応が必要です。

失敗したように見えても結果が未確定の場合がある

通信の途中で応答を受け取れなかったとき、操作が実行されなかった場合と、実行された後で応答だけが届かなかった場合があります。利用者から見える通信の失敗は、処理の不存在を必ず示すものではありません。

この違いがあるため、再試行と同一性の管理を組み合わせます。応答がないたびに新しい出来事として処理すると、最初の操作が完了していた場合に重複した効果が生じます。記録を読むときも、通信結果と業務上の結果を別の欄として理解します。

IDの並びで初回と重複を確認する

A、B、Aのような短いIDを入力し、受信した項目と一意なID、重複した受信を見比べます。

入力値を確かめる準備ができました。

IDの一致だけを扱う簡略例です。実システムでは内容の整合性も照合します。

IDの並びから初回と再送を分ける

短いIDの並びなら、既に見た値の集合を持つことで、初めて出たIDと繰り返し出たIDを区別できます。これは記録の重複の見方を学ぶためのモデルで、個別のサービスの実装を再現したものではありません。

受信順のID初回として数えるID重複受信の回数
A, B, A, CA, B, C1
A, A, AA2
A, B, A, B, AA, B3

A・B・A・Cを一つずつ読む

最初のAは集合にないので新規として数えます。次のBも新規です。3番目のAは既に見た値なので重複、最後のCは新規です。受信した行は4件、異なるIDは3件、重複した受信は1件という関係になります。

この例では、並びを保存すると初回がどの位置だったかも分かります。単に重複を取り除いた一覧だけでは、いつ再送があったかという情報は失われます。集計用の一意な集合と、調査用の元の順序を両方持つ意味があります。

A・A・Aでも出来事は1件と数える

3回続けて同じIDが来た場合、最初の1回を新規、その後の2回を重複として分類します。重複の種類が1種類ということと、重複受信の回数が2回ということは別です。どの件数を示しているかを列名で明確にします。

AとBがそれぞれ2回ずつあれば、重複したIDの種類は2種類、重複受信は2回です。さらにAがもう1回増えれば、種類は変わらず回数だけが増えます。ログを見るときに「重複2件」という短い表示だけでは、意味を確定できない理由です。

空のIDを一つの出来事と数えない

カンマが続いて空欄になった場合、IDが存在しない項目をどう扱うかを決める必要があります。すべての空欄を同じIDと見なすと、互いに関係のない未設定値を一つの出来事へまとめる誤りが生まれます。

この操作例は、各項目の前後の空白を取り除き、空欄は件数に含めません。実際の記録でも、空文字、null、未記載の欄を一意な識別子の代わりにしないことが重要です。IDがない状態と、IDが0という文字である状態は区別します。

イベントの記録を支えるサーバーとネットワーク機器
イベントの記録を支えるサーバーとネットワーク機器 · 写真クレジット

識別子には範囲と内容の条件を添える

同じIDを一意に扱うには、対象となる範囲が必要です。環境や発行元が違えば同じ文字列を使う場合があり、同じキーでも要求内容が変わっていれば、そのまま再送として扱えません。

環境ごとのIDを混ぜない

テスト環境のE-001と、本番環境のE-001が、それぞれ独立した出来事を指す設計もあります。文字列だけを全体でまとめると、片方を誤って重複として落としてしまいます。環境とIDの組を識別の単位にするという考え方が必要です。

複数の提供元をまとめたログでも同様です。提供元Aの001と提供元Bの001は、同じ番号だから同じ出来事とは限りません。どの列が識別範囲を表しているかを確認すると、個々のIDを過大に一意なものとして扱わずに済みます。

大文字・小文字や空白の扱いを決める

ABCとabcを同一視するかは、IDの仕様に依存します。見やすくするためにすべて小文字へ変えたり、空白を削ったりすると、本来区別されていた値をまとめてしまう場合があります。文字の整形は、意味を変えないと確認できる範囲で行います。

比較に使う値と、元の値を両方残す方法もあります。正規化したキーを使う場合は、どの規則で変えたかを記録すると、後から誤った一致を調べやすくなります。見た目が似ていることと、仕様上同じであることを分けます。

同じキーで内容が変わったら衝突を調べる

最初の要求が対象X、後の要求が対象Yなのに同じキーが付いていれば、単なる再送と扱うには内容が一致していません。受け付け側によってはエラーを返し、元の要求と違うことを示す設計があります。

ログでキーが同じなのに数値や対象が変わっている場合も、重複だからと自動で一方を消す前に違いを確認します。再送、訂正、新しい出来事、記録の誤りという複数の可能性を、IDだけではなく内容の条件と合わせて区別する必要があります。

重複排除だけでは、順序や状態は決まらない

同じ出来事を二度数えないことと、出来事を正しい順に並べることは別の問題です。新しいイベントが遅れて届いたり、古い状態を示す記録が後から到着したりする場合があります。

新しいIDが必ず新しい状態とは限らない

E-101を受け取った後でE-100が届いても、番号が小さいから古い状態と断定するには、その番号が順序を保証する仕様が必要です。IDがランダムな文字列なら、文字順や数値の大小には時系列の意味がない場合があります。

発生時刻、受信時刻、状態の版番号が別にあるときは、それぞれ何を表すかを読みます。受信した順番が、出来事が発生した順番と同じとは限りません。重複の確認と、状態を進める条件を別々に設計する理由です。

保留と完了が別イベントとして並ぶ場合

一つの対象について、保留を示すイベントと完了を示すイベントが、それぞれ別のIDで記録される場合があります。対象IDが同じだからといって、後者を重複として消すと、状態の変化を失ってしまいます。

この場合は、対象を識別するIDと、状態の変化を識別するイベントIDの役割が異なります。一つの対象に複数の出来事が結び付く関係を読み取れば、同じ対象の行が多いことと、重複受信が多いことを区別できます。

訂正は同じ行の再送とは違う

内容の訂正を新しいイベントとして残す設計では、元の記録を消さずに訂正との対応を示します。最終的な値だけを見る一覧と、変更の経緯を含むログでは、行数や内容が違って見えることがあります。

重複排除の結果を最終状態の表と同一視しないことが大切です。前者は同じ出来事の繰り返しを取り除く作業で、後者は複数の出来事から現在の状態を組み立てる作業です。必要な関係を失わずに、それぞれの目的に合わせて読める形を保ちます。

イベントの記録を支えるサーバーとネットワーク機器
イベントの記録を支えるサーバーとネットワーク機器 · Helpameout / CC BY-SA 3.0 · 写真クレジット

保存期間と同時処理も重複の扱いを変える

過去のキーを覚えておく仕組みには、保存期間や対象範囲が設けられる場合があります。また、同じキーがほぼ同時に届くと、単純な「調べてから追加する」手順だけでは十分でないことがあります。

キーを覚える期間の外は別の条件になる

あるシステムが一定期間だけキーを保存する場合、その期間内の再試行と、期間が過ぎた後の同じキーの利用では扱いが変わる可能性があります。一般的な冪等性の説明から、すべてのサービスが永久に同じキーを覚えると推測してはいけません。

記録を照合するときも、対象の保存期間と検索範囲を確認します。一覧に以前のキーが見つからないことは、過去に一度も処理されていない証拠にはなりません。保存されていない期間と、出来事がなかった期間は別です。

同時に来た2件を一つとして扱う

同じIDについて二つの処理が同時に「まだない」と判断し、その後それぞれ追加すると、重複が生じます。確認と追加を一つの整合した操作として扱う仕組みが必要になります。単にIDの集合を持つだけでは、実際の並列処理の条件までは説明しきれません。

短いブラウザーのサンプルは、順番に受け取ったIDを分類するモデルです。同時実行や障害復旧まで保証する本番の仕組みとは範囲が異なります。モデルで見える部分と、保存先や処理の仕組みに依存する部分を分けると理解が正確になります。

重複を消す前の記録も調査に役立つ

新規として反映したIDだけを残すと、再送が何回あったか、どの時刻に繰り返されたかが分からなくなります。集計では重複を一度にまとめても、調査用には受信の記録を別に残す設計があります。

ただし、調査用ログにも必要以上の個人情報や秘密情報を含めないことが重要です。識別と経緯を追う目的に必要な項目へ絞り、表示や共有の際は保護します。情報を多く残せば必ず調べやすいとは限らず、扱いの範囲も広がります。

記録の件数を説明するときは、何を数えたかを書く

受信回数、一意なイベント数、対象の件数、最終状態の件数はそれぞれ違う集計です。数字が一致しないときは、まずどの単位を数えているかをそろえると、重複と正常な複数イベントを分けられます。

サンプルのIDを一つずつ増やす

A、B、Aという並びへCを足すと、受信件数と一意なID数が両方1増えます。一方、Aを足すと受信件数だけが1増え、一意なID数は変わりません。何が増えたかを並べて見ると、重複の件数の意味が具体的になります。

IDの並びを入力する例では、実際の個人情報やサービスの秘密のキーを使う必要はありません。AやBという短い値でも、一度見た値かどうかという関係は同じように確認できます。記録の同一性という考え方を、内容から切り離して検算する練習です。

状態の文字とIDをセットで読む

同じAというIDに同じ状態が繰り返されている場合と、対象Xに異なるイベントIDで状態変化が並ぶ場合では、意味が違います。列の見出しにevent_idとobject_idがあるなら、それぞれを別の役割として読みます。

状態の名称だけでまとめると、別の対象の完了イベントまで一つにしてしまいます。IDだけでまとめても、異なる発行元が混ざれば誤った一致が起こります。何を一つとして扱うかという条件を、集計結果と一緒に残すことが重要です。

結果を短い数字だけで伝えない

「重複が3件」とだけ伝える代わりに、「5回受信し、一意なIDは2件、再受信は3回」と書くと、件数の対応が伝わります。種類と回数を混ぜないため、他の記録とも比較しやすくなります。

一覧の説明でも、対象期間、発行元、IDの比較方法をそろえると、件数が変わった理由を追いやすくなります。値の同一性を決める条件を省かずに数字を読むことが、記録を過不足なく理解する基本になります。

イベントの記録を支えるサーバーとネットワーク機器
イベントの記録を支えるサーバーとネットワーク機器 · Victorgrigas / CC BY-SA 4.0 · 写真クレジット

よくある質問

同じIDが2回あると、処理も2回ですか?

必ずしもそうではありません。同じイベントの再送を2回受信している場合があります。受信回数と、反映した一意なイベント数を別に確認します。

同じ金額や状態なら重複ですか?

値が同じだけでは同じ出来事と判断できません。別の対象や別のラウンドのイベントが同じ内容になる場合があるため、識別子とその範囲を確認します。

冪等性と、同じ応答を返すことは同じですか?

中心になるのは繰り返したときの効果です。表示時刻などが変わっても新しい重複した対象を作らない場合があり、逆に同じ成功文でも内部の効果が重なる場合があります。

イベントIDと対象IDは違いますか?

対象IDは一つの対象を、イベントIDはその対象に起きた個々の出来事を識別する設計があります。一つの対象に複数の状態変化が記録される関係です。

受信した順序が発生した順序ですか?

一致するとは限りません。遅れて届くイベントもあるため、発生時刻、受信時刻、版番号などの意味を分けて読みます。

空のIDを同じイベントとしてまとめてよいですか?

IDが欠けた複数の記録が、同じ出来事とは限りません。空欄や未設定の値を、一意な識別子の代わりとして扱わないことが重要です。

IDの大文字と小文字は無視できますか?

仕様によります。大文字小文字を区別するIDもあるため、見た目をそろえる目的だけで変換すると別の値をまとめてしまう場合があります。

再送ログは全部消してよいですか?

集計用には一度へまとめても、受信回数や時刻は調査に役立つ場合があります。集計結果と元の受信記録を用途ごとに分け、不要な個人情報は含めないようにします。