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.9k

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.5k
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
150
Go Code Review Comment を翻訳した話
Avatar for Kenshi Kamata knsh14
0
7.6k
tvOS Leaderboard
Avatar for Kenshi Kamata knsh14
0
1.2k

Other Decks in Technology

See All in Technology
夢の無限スパゲッティ製造機 #phperkaigi
Avatar for hideki kinjyo o0h
PRO
0
360
「お金で解決」が全てではない！大規模WebアプリのCI高速化 #phperkaigi
Avatar for すてにゃん stefafafan
5
2.2k
SaaSに宿る21g
Avatar for Yamakan kanyamaguc
2
150
AIエージェント勉強会第3回 エージェンティックAIの時代がやってきた
Avatar for Y.Miyado ymiya55
0
110
事例から紐解くSHIFT流QA支援 ～大規模プロジェクトの品質管理支援、QA組織立ち上げ～ / 20260320 Nozomu Koketsu
Avatar for SHIFT EVOLVE shift_evolve
PRO
0
140
DDD×仕様駆動で回す高品質開発のプロセス設計
Avatar for Koichiro Matsuoka littlehands
5
2.3k
今日から始められるテスト自動化 〜 基礎知識から生成AI活用まで 〜
Avatar for MagicPod magicpod
1
140
ReactのdangerouslySetInnerHTMLは“dangerously”だから危険 / Security.any #09 卒業したいセキュリティLT
Avatar for GMO Flatt Security flatt_security
0
480
The Rise of Browser Automation: AI-Powered Web Interaction in 2026
Avatar for Marc Thompson marcthompson_seo
0
310
_Architecture_Modernization_から学ぶ現状理解から設計への道のり.pdf
Avatar for SatohJohn satohjohn
2
740
【PHPerKaigi2026】OpenTelemetry SDKを使ってPHPでAPMを自作する
Avatar for Futoshi Endo fendo181
1
180
FastMCP OAuth Proxy with Cognito
Avatar for iganin hironobuiga
3
180

Featured

See All Featured
10 Git Anti Patterns You Should be Aware of
Avatar for Lemi Orhan Ergin lemiorhan
PRO
659
61k
The Art of Programming - Codeland 2020
Avatar for Erika Heidi erikaheidi
57
14k
Stop Working from a Prison Cell
Avatar for Chris Michel hatefulcrawdad
274
21k
GitHub's CSS Performance
Avatar for Jon Rohan jonrohan
1032
470k
Why Your Marketing Sucks and What You Can Do About It - Sophie Logan
Avatar for Sophie Logan marketingsoph
0
120
Highjacked: Video Game Concept Design
Avatar for Ryan Kendrick rkendrick25
PRO
1
320
実際に使うSQLの書き方 徹底解説 / pgcon21j-tutorial
Avatar for soudai sone soudai
PRO
199
73k
Evolving SEO for Evolving Search Engines
Avatar for Ryan Jones ryanjones
0
170
[RailsConf 2023 Opening Keynote] The Magic of Rails
Avatar for Eileen M. Uchitelle eileencodes
31
10k
The Myth of the Modular Monolith - Day 2 Keynote - Rails World 2024
Avatar for Eileen M. Uchitelle eileencodes
26
3.4k
The untapped power of vector embeddings
Avatar for Frank van Dijk frankvandijk
2
1.6k
StorybookのUI Testing Handbookを読んだ
Avatar for Shingo Yamazaki zakiyama
31
6.6k

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