Upgrade to Pro — share decks privately, control downloads, hide ads and more …

500万ユーザーを支える残高の冪等性 / The idempotency of the bal...

Avatar for Kenshi Kamata 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/) での発表資料

Avatar for Kenshi Kamata

Kenshi Kamata

December 18, 2019
Tweet

More Decks by Kenshi Kamata

See All by Kenshi Kamata
チャネルの仕組み
Avatar for Kenshi Kamata knsh14
6
5.4k
Go1.10 strings.Builder の紹介
Avatar for Kenshi Kamata knsh14
2
1.4k
Go でインタプリタを 書いてみよう
Avatar for Kenshi Kamata knsh14
0
3k
Let’s Create An Interpreter In Go
Avatar for Kenshi Kamata knsh14
0
140
Go Code Review Comment を翻訳した話
Avatar for Kenshi Kamata knsh14
0
7.5k
tvOS Leaderboard
Avatar for Kenshi Kamata knsh14
0
1.2k

Other Decks in Technology

See All in Technology
The Complete Android UI Testing Landscape: From Journey to Traditional Approaches
Avatar for Alex Zhukovich alexzhukovich
1
110
AI開発の定着を推進するために揃えるべき前提
Avatar for Suguru Ohki suguruooki
1
240
Building AI Applications with Java, LLMs, and Spring AI
Avatar for Thomas Vitale thomasvitale
1
240
Dev Containers と Skaffold で実現する クラウドネイティブ開発環境 ローカルのみという制約に挑む / Cloud-Native Development with Dev Containers and Skaffold: Tackling the Local-Only Constraint
Avatar for 株式会社ビットキー / Bitkey Inc. bitkey
PRO
0
130
リアーキテクティングのその先へ 〜品質と開発生産性の壁を越えるプラットフォーム戦略〜 / architecture-con2025
Avatar for Visional Engineering ＆ Design visional_engineering_and_design
0
6.8k
IPv6-mostly field report from RubyKaigi 2026
Avatar for Sorah Fukumori sorah
0
190
OSだってコンテナしたい❗Image Modeが切り拓くLinux OS運用の新時代
Avatar for Masataka Tsukamoto tsukaman
0
130
機械学習を「社会実装」するということ 2025年冬版 / Social Implementation of Machine Learning November 2025 Version
Avatar for Moe Uchiike（内池 もえ） moepy_stats
4
220
AI エージェント活用のベストプラクティスと今後の課題
Avatar for Asei Sugiyama asei
2
300
『ソフトウェア』で『リアル』を動かす：クレーンゲームからデータ基盤までの統一アーキテクチャ / アーキテクチャConference 2025
Avatar for GENDA genda
0
310
変わるもの、変わらないもの ：OSSアーキテクチャで実現する持続可能なシステム
Avatar for gree_tech gree_tech
PRO
0
770
LINEギフト・LINEコマース領域の開発
Avatar for LINEヤフーTech (LY Corporation Tech) lycorptech_jp
PRO
0
380

Featured

See All Featured
Practical Tips for Bootstrapping Information Extraction Pipelines
Avatar for Matthew Honnibal honnibal
25
1.6k
個人開発の失敗を避けるイケてる考え方 / tips for indie hackers
Avatar for panda_program panda_program
118
20k
Creating an realtime collaboration tool: Agile Flush - .NET Oxford
Avatar for Marc Duiker marcduiker
34
2.3k
Side Projects
Avatar for Sacha Greif sachag
455
43k
Practical Orchestrator
Avatar for Shlomi Noach shlominoach
190
11k
Making the Leap to Tech Lead
Avatar for Ryan Cromwell cromwellryan
135
9.6k
Typedesign – Prime Four
Avatar for Hannes Fritz hannesfritz
42
2.9k
Leading Effective Engineering Teams in the AI Era
Avatar for Addy Osmani addyosmani
8
1.1k
What's in a price? How to price your products and services
Avatar for Michael Herold michaelherold
246
12k
Responsive Adventures: Dirty Tricks From The Dark Corners of Front-End
Avatar for Vitaly Friedman smashingmag
253
22k
Statistics for Hackers
Avatar for Jake VanderPlas jakevdp
799
230k
Rebuilding a faster, lazier Slack
Avatar for samanthasiow samanthasiow
84
9.3k

Transcript

  1. knsh14
 500万ユーザーを支える残高の冪等性


  2. 鎌田健史(@knsh14)
 • Merpay Backend Engineer
 • Payment Platform team
 2

    自己紹介


  3. 残高を管理するマイクロサービス 01 残高を管理するAPIの冪等性 02 冪等性をもたせるときに考えること 03 3 アジェンダ


  4. 残高管理マイクロサービスの紹介
 4

  5. 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 残高管理マイクロサービスの紹介


  6. 残高管理サービス
 • 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 残高管理マイクロサービスの紹介


  7. 残高管理マイクロサービス(Balance Service)の特徴
 • 使っているDBはCloud Spanner
 • 外部のサービスや他のマイクロサービスに依存してない
 • Delete 操作はなくて

    Read / Insert / Update のみ
 • かなりシンプルな存在
 7 残高管理マイクロサービスの紹介


  8. Balance Service の冪等性
 8

  9. 冪等性があるAPI
 01 02 お客様の残高を追加や消費 冪等性がないAPI
 お客様の現在の残高を取得 消費の履歴を取得 9 Balance Service

    の冪等性


  10. 冪等性があるAPI
 • ある取引は最初に成功した1度だけ処理される
 • 1度成功すれば同じリクエストを何回繰り返しても内部的には処理され ない
 • 何度リクエストしてもレスポンスは同じものが返ってくる
 • 何度でもリトライできる


    10 Balance Service の冪等性


  11. 冪等性があるAPI
 • リクエストの取引IDが保存されていれば既に行われた取引である
 • リクエスト内容をチェックして結果を返す
 ◦ 偶然同じ取引IDになっても弾けるように 11 Balance Service

    の冪等性


  12. 冪等性キーが同じ
 01 02 03 外部から指定される取引ID 残高の種類が同じ
 ポイント/メルペイ残高など
 操作する額が同じ
 ポイントがP〇〇 メルペイ残高が￥△△

    12 Balance Service の冪等性


  13. 冪等なレスポンス
 • レスポンスはDBから引ける情報で組み立てる
 • 取引IDから引ける情報
 ◦ 取引後の残高などは返さない 13 Balance Service

    の冪等性


  14. 冪等なAPIでのエラー
 • エラーはリクエストする側にリトライさせるか決める材料になる
 • リトライしても良いエラー
 ◦ タイムアウトなど • リトライしても意味がないエラー
 ◦

    そもそも残高不足など 14 Balance Service の冪等性


  15. 冪等性を持たせるときに考えること
 15

  16. 誰がどう使うのか？
 冪等になるためのリクエスト
 01 02 16 冪等性を持たせるときに考えること


  17. 誰がどう使うのか？
 • リクエストを投げる側の使い方1つで簡単に冪等性は壊れる
 • どういう情報でリクエストするのか、どうやってリトライするのか
 17 冪等性を持たせるときに考えること


  18. 冪等にするためのリクエスト
 • UUID 使っとけば OK やろ？みたいな話ではない
 • 自分のマイクロサービスをよく考えて決める
 18 冪等性を持たせるときに考えること


  19. 冪等性のための要素はドメイン次第
 Balance Serviceではリクエスト内容
 まで含めた情報で冪等になる
 自分だけでは冪等性は守れないので
 コミュニケーション大事
 01 02 03 19

    まとめ


  20. おわり
 20