Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
500万ユーザーを支える残高の冪等性 / The idempotency of the bal...
Search
Kenshi Kamata
December 18, 2019
Technology
0
2.8k
500万ユーザーを支える残高の冪等性 / The idempotency of the balance for 5 million Merpay users
Tech Talk vol.2 Backend Engineer 〜マイクロサービスの冪等性〜 (
https://mercari.connpass.com/event/157009/
) での発表資料
Kenshi Kamata
December 18, 2019
Tweet
Share
More Decks by Kenshi Kamata
See All by Kenshi Kamata
チャネルの仕組み
knsh14
6
5.4k
Go1.10 strings.Builder の紹介
knsh14
2
1.4k
Go でインタプリタを 書いてみよう
knsh14
0
2.9k
Let’s Create An Interpreter In Go
knsh14
0
140
Go Code Review Comment を翻訳した話
knsh14
0
7.5k
tvOS Leaderboard
knsh14
0
1.2k
Other Decks in Technology
See All in Technology
『OCI で学ぶクラウドネイティブ 実践 × 理論ガイド』 書籍概要
oracle4engineer
PRO
2
120
多様な事業ドメインのクリエイターへ 価値を届けるための営みについて
massyuu
1
380
定期的な価値提供だけじゃない、スクラムが導くチームの共創化 / 20251004 Naoki Takahashi
shift_evolve
PRO
3
330
ACA でMAGI システムを社内で展開しようとした話
mappie_kochi
1
280
「AI駆動PO」を考えてみる - 作る速さから価値のスループットへ:検査・適応で未来を開発 / AI-driven product owner. scrummat2025
yosuke_nagai
4
620
Optuna DashboardにおけるPLaMo2連携機能の紹介 / PFN LLM セミナー
pfn
PRO
2
900
AWSにおけるTrend Vision Oneの効果について
shimak
0
130
SOC2取得の全体像
shonansurvivors
1
410
ZOZOのAI活用実践〜社内基盤からサービス応用まで〜
zozotech
PRO
0
190
許しとアジャイル
jnuank
1
130
Goに育てられ開発者向けセキュリティ事業を立ち上げた僕が今向き合う、AI × セキュリティの最前線 / Go Conference 2025
flatt_security
0
350
生成AIで「お客様の声」を ストーリーに変える 新潮流「Generative ETL」
ishikawa_satoru
1
330
Featured
See All Featured
Put a Button on it: Removing Barriers to Going Fast.
kastner
60
4k
No one is an island. Learnings from fostering a developers community.
thoeni
21
3.5k
Unsuck your backbone
ammeep
671
58k
Large-scale JavaScript Application Architecture
addyosmani
514
110k
Site-Speed That Sticks
csswizardry
11
880
Templates, Plugins, & Blocks: Oh My! Creating the theme that thinks of everything
marktimemedia
31
2.5k
The Cost Of JavaScript in 2023
addyosmani
53
9k
Context Engineering - Making Every Token Count
addyosmani
5
200
Design and Strategy: How to Deal with People Who Don’t "Get" Design
morganepeng
132
19k
The Illustrated Children's Guide to Kubernetes
chrisshort
48
51k
Build The Right Thing And Hit Your Dates
maggiecrowley
37
2.9k
GitHub's CSS Performance
jonrohan
1032
460k
Transcript
knsh14 500万ユーザーを支える残高の冪等性
鎌田健史(@knsh14) • Merpay Backend Engineer • Payment Platform team 2
自己紹介
残高を管理するマイクロサービス 01 残高を管理するAPIの冪等性 02 冪等性をもたせるときに考えること 03 3 アジェンダ
残高管理マイクロサービスの紹介 4
Open SKT から紹介 • https://speakerdeck.com/kazegusuri/builderscon-tokyo-2019-open-s kt • https://builderscon.io/tokyo/2019/session/c50caef7-a858-43c6-adc a-de4341094d4a
• メルペイのアーキテクチャについての神解説 5 残高管理マイクロサービスの紹介
残高管理サービス • https://speakerdeck.com/kazegusuri/builderscon-tokyo-2019-open-s kt?slide=17 • https://speakerdeck.com/kazegusuri/builderscon-tokyo-2019-open-s kt?slide=19 •
決済のドメイン機能の一部を構成している 6 残高管理マイクロサービスの紹介
残高管理マイクロサービス(Balance Service)の特徴 • 使っているDBはCloud Spanner • 外部のサービスや他のマイクロサービスに依存してない • Delete 操作はなくて
Read / Insert / Update のみ • かなりシンプルな存在 7 残高管理マイクロサービスの紹介
Balance Service の冪等性 8
冪等性があるAPI 01 02 お客様の残高を追加や消費 冪等性がないAPI お客様の現在の残高を取得 消費の履歴を取得 9 Balance Service
の冪等性
冪等性があるAPI • ある取引は最初に成功した1度だけ処理される • 1度成功すれば同じリクエストを何回繰り返しても内部的には処理され ない • 何度リクエストしてもレスポンスは同じものが返ってくる • 何度でもリトライできる
10 Balance Service の冪等性
冪等性があるAPI • リクエストの取引IDが保存されていれば既に行われた取引である • リクエスト内容をチェックして結果を返す ◦ 偶然同じ取引IDになっても弾けるように 11 Balance Service
の冪等性
冪等性キーが同じ 01 02 03 外部から指定される取引ID 残高の種類が同じ ポイント/メルペイ残高など 操作する額が同じ ポイントがP〇〇 メルペイ残高が¥△△
12 Balance Service の冪等性
冪等なレスポンス • レスポンスはDBから引ける情報で組み立てる • 取引IDから引ける情報 ◦ 取引後の残高などは返さない 13 Balance Service
の冪等性
冪等なAPIでのエラー • エラーはリクエストする側にリトライさせるか決める材料になる • リトライしても良いエラー ◦ タイムアウトなど • リトライしても意味がないエラー ◦
そもそも残高不足など 14 Balance Service の冪等性
冪等性を持たせるときに考えること 15
誰がどう使うのか? 冪等になるためのリクエスト 01 02 16 冪等性を持たせるときに考えること
誰がどう使うのか? • リクエストを投げる側の使い方1つで簡単に冪等性は壊れる • どういう情報でリクエストするのか、どうやってリトライするのか 17 冪等性を持たせるときに考えること
冪等にするためのリクエスト • UUID 使っとけば OK やろ?みたいな話ではない • 自分のマイクロサービスをよく考えて決める 18 冪等性を持たせるときに考えること
冪等性のための要素はドメイン次第 Balance Serviceではリクエスト内容 まで含めた情報で冪等になる 自分だけでは冪等性は守れないので コミュニケーション大事 01 02 03 19
まとめ
おわり 20