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

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.6k
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
2
900
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
2.3k
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
73
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
5.9k
Fd1ded499f7831ddb01b0d23eb9b64c2?s=48 knsh14
0
1k

Other Decks in Technology

See All in Technology
53850955f15249a1a9dc49df6113e400?s=48 line_developers
PRO
1
550
8fa31051503b09846584c49cd53d2f80?s=48 asei
1
800
49f49940f0831a426745c028684bcdad?s=48 hatena
0
3.3k
53850955f15249a1a9dc49df6113e400?s=48 line_developers
PRO
0
220
79dcb04101764d7bf66f898dd446838e?s=48 tsukubachallenge
0
180
351ad6de24f57760f9275bc0ad06e564?s=48 quiver
0
250
2cf373725ded741824c50fd571eda6e1?s=48 udzura
0
180
4cafe6a1c6287d64d7252279eeeffa94?s=48 moongift
0
150
195f71c8183f8d27da66aa0618f293b6?s=48 task4233
0
340
413a764e6df9d7f2adbddb0b278ebb7e?s=48 sosai
0
200
7cb78d6108cc74bec0f2f001127f662a?s=48 hiroki_hasegawa
0
130
648cff4d467bb490796a225da8f33797?s=48 onysuke
1
190

Featured

See All Featured
24fc194843a71f10949be18d5a692682?s=48 gr2m
86
11k
Ae14cc4491ac334f9cd23f9f93b4305e?s=48 orderedlist
PRO
331
36k
7fa6101cd43067653cf4ac6c7ca54305?s=48 akmur
255
20k
Af6a12710770ad9a7cfd08c97efd40d3?s=48 pedronauck
655
120k
E76911cbe088e5b850d966de3fc7435b?s=48 robhawkes
56
3k
1f74b13f1e5c6c69cb5d7fbaabb1e2cb?s=48 sferik
612
56k
B6a8f005f39d23ffc930508ac9da68b9?s=48 vanstee
122
5.1k
9cde37f47e4a800ea081ea42de8d749a?s=48 dougneiner
122
8.3k
9128d500301ae51524e887bb680f471d?s=48 caitiem20
314
18k
4262b9cfacfb6b2c77f23e1d0310cd3e?s=48 myddelton
110
11k
E9221b172e78e888355fa2fe4541b595?s=48 mclloyd
PRO
6
7.5k
7559f6cff1f5efc2d210965febd4d71c?s=48 bermonpainter
348
27k

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