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

500万ユーザーを支える残高の冪等性 / The idempotency of the balance for 5 million Merpay users

Fd1ded499f7831ddb01b0d23eb9b64c2?s=47 Kenshi Kamata
December 18, 2019
Technology
0
1.7k

500万ユーザーを支える残高の冪等性 / The idempotency of the balance for 5 million Merpay users

Tech Talk vol.2 Backend Engineer 〜マイクロサービスの冪等性〜 (https://mercari.connpass.com/event/157009/) での発表資料

Fd1ded499f7831ddb01b0d23eb9b64c2?s=128

Kenshi Kamata

December 18, 2019
Tweet

More Decks by Kenshi Kamata

See All by Kenshi Kamata
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
6
4.4k
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
2
850
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
2.2k
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
72
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
5.7k
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
1k

Other Decks in Technology

See All in Technology
332f89cc697355902a817506b6995f2b?s=48 ytaka23
9
2.3k
966e29b84ae7dbde170f66b0bc75b7a6?s=48 ishiayaya
PRO
0
850
Cc49268bebed3e30cb943a9de7b6eb3a?s=48 lain21
14
5.3k
525442fc70ca92f82ae503f826956137?s=48 finengine
0
260
23f4d5d797a91b6d17d627b90b5a42d9?s=48 kentaro
2
510
Cd931bc05e7cee46b9a950a63e47ba4c?s=48 you
0
100
0d9e60b12d0a40841b1a746b112ad36b?s=48 aamine
4
890
Bf7fe621f4fe1615c228ef8a79b87282?s=48 shirayanagiryuji
1
180
0d29d155ce5c5a93ed46363626da3ea7?s=48 ocise
0
120
53850955f15249a1a9dc49df6113e400?s=48 line_developers
PRO
2
180
842515eaf8fbb2dfcc75197e7797dc15?s=48 sat
2
2.1k
00101a1274d1f92977f4e442ef73be86?s=48 ahana
0
450

Featured

See All Featured
56c4053438af8e8b90d6f53cbb7573be?s=48 jakevdp
776
200k
95d9f37115fbb0d13135d0f77132f856?s=48 morganepeng
94
14k
5ce91fa49a613cbc3e20d5f96856473f?s=48 edds
56
9.4k
Bfd6b681ec6e8c9bef82ff0521c364f7?s=48 kastner
54
2k
9952dfcd5d338f8a8e7175c8a8f65fb5?s=48 wjessup
340
16k
C51b39fa3c79ccb99dcb8a076bc98287?s=48 brianwarren
82
4.8k
433acaea1012b25d97ae66da9b998dad?s=48 malarkey
392
61k
8081b26e05bb4354f7d65ffc34cbbd67?s=48 chriscoyier
683
180k
D8fc2580cfaca035f666d9e4ee79a7f7?s=48 mongodb
23
3.9k
E6c6e133e74c3b83f04d2861deaa1c20?s=48 searls
204
37k
B3ace07412a5178ea778e7eec161fc0a?s=48 jcasabona
8
590
E837d2996f52008ace055a08fbfff992?s=48 frogandcode
128
20k

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