ETCカードに対応するため、クレジットカードの決済を無停止でDBマイグレーションするときに考えたこと

## はじめに こんにちは、バクラクビジネスカード開発チームの [@budougumi0617](https://x.com/budougumi0617) です。 先月まではテックリードでしたが、4月からエンジニアリングマネージャになりました。 バクラクビジネスカードは2022年からサービスを提供している法人様向けクレジットカードのサービスです。昨年2025年からはETCカードのサービス提供も開始しました。 [prtimes.jp](https://prtimes.jp/main/html/rd/p/000000516.000036528.html) 本記事では、もともとクレジットカードの決済データを受け取ることのみを前提に設計されていたバクラクビジネスカードのデータベースに対して新しくETCカードの決済データも受け入れられるようにマイグレーションを行なったときに考えたことをまとめます。 要点を先に書くと、次の3つです。 - 約3年分の決済レコードが蓄積された本番DBに対して、サービス無停止でスキーマ変更を完了した - テーブルごとに許容できるマイグレーション時間も考慮しながらマイグレーション戦略を切り分けた - 本番DBの複製を利用した実データを用いたマイグレーション時間の事前計測 決済系プロダクトでスキーマ拡張を行うエンジニアや、歴史あるサービスでの大きめのDBマイグレーションを検討している方にとって、なんらかのヒントになれば幸いです。 バクラクビジネスカードは他のバクラクプロダクトと連携し、クレジットカードの決済から経費精算・経理担当の会計処理までのシームレスな体験を提供しています。 「クレジットカードの体験をETCカードでも提供してほしい」と希望するお客様の声は常にありました。 ここで、バクラクビジネスカードはプロセシングプラットフォームであるインフキュリオン様のXardを利用してクレジットカード機能を開発しています。 2025年、XardでETCカード発行サービスがリリースされることになり、バクラクでもETCカードを提供することとなりました。 [インフキュリオン、「Xard（エクサード）」の新オプション機能として 「ETCカード発行」サービスを2025年7月より提供開始 - Infcurion, Inc.](https://infcurion.com/news/news-20250612_001/) Xardを利用したETCカードは、通常のクレジットカードと同じAPIを用いてETCカードの発行および高速道路利用時の決済情報を受け取ることができます。 バクラクビジネスカードのオプションとしてETCカードを新たに提供するにあたり、技術的に大きな問いが1つありました。 それは、クレジットカードの決済情報を受け取ることのみを前提としたデータベースのテーブルをETCカードの決済情報にも対応させることでした。 ## クレジットカードの決済情報テーブルをETCカードの決済情報にも対応するように拡張する バクラクビジネスカードは、Xardからの決済リクエスト、Webhookを受信して決済を処理しています。 クレジットカード（以降クレカ）の決済情報とETCカードの決済情報では含まれる内容に違いがあることが事前にわかっていました。 ## クレカとETCの決済データの差分 ETCの決済データは、クレジットカードの決済データといくつかは共通している一方、各々で固有の項目もそれなりにあります。たとえば以下のとおりです。 - 共通項目：決済金額、決済日時、カードを特定する情報など - クレジットカード固有の項目：加盟店名などISO8583で定義された情報1 - ETC固有の項目：入口・出口インターチェンジ名、車種など2 ## 2つの大きな制約 今回のカード・決済情報テーブルのETCカード対応拡張に着手するうえで、外せない制約が2つありました。 1つ目は「無停止要件」です。クレジットカードはお客様が24時間365日利用するサービスです。 決済を止めるメンテナンスはどうしても回避できない場合を除き行わない方針で開発・運用をしています。 2つ目は「既存データ量」です。バクラクビジネスカードはリリースから3年以上が経過し、主要テーブルには3年分の決済情報のレコードが蓄積されていて、今この瞬間にも新たな決済明細のレコードが増え続けています。ローカルでは一瞬のマイグレーションも、本番では何分・何十分とかかる可能性がありました。 「無停止」と「3年分のレコードを抱えたテーブルへの変更」が同時に求められる、これが今回の出発点です。 ## テーブルがどのようなユースケースで利用されているか考える スキーマ拡張の議論を始めると、つい「どんなテーブル設計が綺麗か」「どんなマイグレーションが速いか」という話に目が向きがちです。 しかし、今回のETC対応で最初に行なったのは、**そのテーブルが本番でどう利用されているかを見る**という工程でした。同じスキーマ変更要件でも、当てるテーブルの利用パターンが違えば、許される操作の幅も大きく変わります。 バクラクビジネスカードの決済処理を構成するテーブルは、本番での利用のされ方が大きく異なる2系統に分けられました。 - 系統A：決済処理APIに紐づくテーブル 指定時間以内にレスポンスを返さなければ決済そのものが失敗扱いになる経路で参照・更新されます - 既存処理に与える影響を限りなく小さくする必要があります - 許されるのは「短時間で完了し、マイグレーション後もアプリの挙動に影響がない」スキーマ変更です - 系統B：Webhook経由の非同期処理に紐づくテーブル 外部からのイベントを弊社システム内部のキュー経由で非同期に処理する経路で参照・更新されます - 一時的な処理失敗はキューで再処理できる設計になっており、ある程度の処理遅延・実行時間を許容できる経路です - サブテーブル分離など、踏み込んだスキーマ変更も現実的な選択肢になります この2系統を同列に扱ってしまうと、「全テーブルを最速で完了させる」という強い縛りが生まれ、選べる打ち手が極端に狭くなります。逆に切り分ければ、系統Aには本当に安全な操作だけを当て、系統Bには踏み込んだ変更を入れる、という割り当て方ができます。 非同期経路のWebhook基盤の設計については、過去の発表資料もあわせてご覧ください。 [speakerdeck.com](https://speakerdeck.com/shnjtk/layerx-bakuraku-how-to-handle-incoming-webhooks-with-difference-specifications-in-unified-way) ## 系統ごとに違うアプローチを選ぶ テーブルの利用パターンが違うことを踏まえて、ETC対応のスキーマ拡張も系統ごとに違うアプローチをとりました。 ## 系統A：既存テーブルに最小限の変更だけを当て新規テーブルを追加する API処理側のテーブルには、**既存クエリの形を変えずに済む最小限のスキーマ変更**だけを当てる方針にしました。 具体的には、決済の親テーブルに種別を見分けるカラムを1つ追加し、ETC固有の付随情報は新規テーブルに寄せる構造です。 もともと決済処理APIの内容を格納しておくテーブルは2つに分かれていました。 - IDや受信時刻など基本的な情報を持つ親テーブル - 金額や加盟店名などに関する詳細テーブル そこで詳細テーブルはクレカ用として既存のまま残し、ETC側は新規に別の詳細テーブルを用意することにしました。 判断軸はシンプルで、API処理側では次の3点が強く求められたからです。 - 既存クエリへの影響を最小化すること - 明細表示や集計クエリを1テーブルで完結させること（UNIONや分岐を増やさない） - マイグレーション中・マイグレーション後もアプリケーションが決済を処理し続けられること 修正前後の構造のイメージは次のとおりです。 修正後 種別=ETC のときのみ参照 親テーブル**種別カラム 詳細サブテーブル (クレカ用とする） ETC用詳細情報テーブル （新規） 修正前 親テーブル 詳細情報テーブル ## 系統B：共通テーブル＋種別ごとのサブテーブルに分ける Webhook経由側のテーブルも最終的な形は似た構造になるように変更しました。 Webhookで受け取る生データは最初1テーブルで全てを含んでいました。 そのテーブルにETCカードのカラムを追加するとクレカ・ETCカードでお互いNULLになるカラムが増え、意味づけも複雑化します。 そこで、共通テーブルには種別を見分ける情報**を持たせ、種別固有のデータは**サブテーブルに完全分離**する形にしました。修正前後の構造のイメージは次のとおりです。 修正後 種別=クレカ 種別=ETC 共通テーブル**+ 種別カラム （クレカ用カラムは後日DROP） クレカ用 詳細サブテーブル （新規） ETC用 詳細サブテーブル （新規） 修正前 共通テーブル （クレカ用カラムも含む） このアプローチではデータの扱いが大きく代わりますが、共通テーブルへのカラムのDROPを後日行えばマイグレーション実行直後でもアプリケーションは問題なく動きます。 そのかわり新設したサブテーブルへ過去分のデータをバックフィルする作業や、共通テーブル側の旧カラムを段階的に整理していく作業も発生します。 しかしこれらの「時間のかかるデータ移行作業」でも、Webhook経路の場合は移行作業中にWebhook処理が失敗してもキューの再実行によりリカバリが可能です。 ## 同じ要件、違う実装手段 ETC対応で必要だった共通要件をまとめると、次の3つでした。 - カード種別を識別する仕組み - ETC固有データを保持する場所 - 既存クレカ機能への影響を出さないこと 同じ要件でも、系統Aと系統Bでは実装手段が違います。 - 系統A：既存テーブルの延長線上で考える - 系統B：多少実行コストがかかってもデータを整理する 「全テーブルで同じマイグレーション戦法をとる」という方針を強引に当てはめないことで、それぞれのテーブルの本番利用に合った形に落とし込めました。 ## マイグレーションを当てる前に、実データ量で測る 設計のアプローチが決まっても、本番にそのまま実行してよいとは限りません。先に述べたとおり、ローカルでは一瞬で完了する DDL でも本番のデータ量では想定外のロックや所要時間で決済を巻き込むリスクがあります。 ここで効いてきたのが、本番相当の実データ量で DDL の実行時間を必ず検証する**という工程でした。バクラクプロダクトでは、権限管理された本番クローン環境で、事前に DDL を検証できる Bytebase をフロントにおいた SQL 実行基盤があります。詳しくは以下の記事をご覧ください。 [tech.layerx.co.jp](https://tech.layerx.co.jp/entry/2024/07/04/120631) この基盤の上で、今回投入したい DDL を実際に流し、所要時間とロックの挙動を計測しました。チェックしたのは主に次の点です。 - カラム追加が ALGORITHM=INSTANT で完了するか、それともテーブルコピーになるか - 「カード種別を識別するカラム」の追加が高速で終わるか - 新規インデックス追加にかかる時間と、その間の参照／更新への影響 - DROP COLUMN にどれくらい時間がかかるのか 検証で得られた所要時間が、系統 A・系統 B それぞれの戦略を本番に当てて良いかの判断根拠になりました。 複製環境ではデータが消える DROP COLUMN も気兼ねなく試せたため、戦略の幅も広く取れます。何より「確かめはしたけれど本番で本当に問題ないか不安」という気持ちにならずに自信をもってマイグレーション実行日を迎えることができました。 ## 実施と結果 運用中のテーブルへのマイグレーションのため、実際のマイグレーションではアプリケーションコードの CRUD が壊れないかを QA で確認しつつ、本番環境へメンテナンスタイムなしでマイグレーションを実施していきました。 結果として、今回の一連のスキーマ変更について、マイグレーション起因の決済失敗は確認されず、メンテナンスタイムなしで完了することができました。 2025 年夏にリリースしてからとくに問題なく ETC カードの処理も行えています。 ## 学びと振り返り 今回のプロジェクトで、後続のスキーマ変更にも持ち越したい学びは次のあたりです。 - マイグレーションアプローチは、テーブルの本番利用に合わせて選ぶ API 処理に紐づくテーブルには軽量な変更を当て、Webhook 経由のテーブルには踏み込んだ変更を当てる、という割り当てが ETC 対応で機能しました。同じ考え方は決済に限らず、EC の注文テーブルへの配送種別追加、SaaS の課金テーブルへの新プラン追加など、SLA の厳しい経路と緩い経路が同居するシステム全般に応用できます。 - マイグレーションは実データ量で測ってから当てる ローカルでの感覚と本番でのふるまいは違います。本番相当のデータで実際に流して数字を見ることで、「この変更は適用できる」「この方針は見直すべき」という判断を実測値にもとづいて行えました。 - 本番クローン環境は意思決定の精度を上げる 単なる検証ツールではなく、設計や戦略そのものを引き返す根拠として機能しました。 ## おわりに クレジットカードは停止できないからこそ、「停止せずにどう変更するか」を設計と意思決定の中心に置く必要があります。今回はETCカードの追加という形で、その難しさと面白さについて、設計と運用の両面から向き合いました。 **本番環境でのテーブル利用状況を見てからアプローチを決める**こと、そして**実データ量に基づいて実行時間を必ず検証する**こと、この2つが今回の無停止マイグレーションを支えました。 バクラクビジネスカードを開発しているバクラク事業部のPayment開発部では、今年もBPSP（Business Payment Service Provider）をリリースしたり、新たな決済サービスの開発を続けています。 [prtimes.jp](https://prtimes.jp/main/html/rd/p/000000607.000036528.html) AIエージェントや決済サービスの開発に少しでも興味がある！という方はぜひ以下からご応募ください！ [open.talentio.com](https://open.talentio.com/r/1/c/layerx/pages/61168) - https://infcurion.com/xard/case/layerx/↩ - https://infcurion.com/news/news-20250612_001/↩

ETCカードに対応するため、クレジットカードの決済を無停止でDBマイグレーションするときに考えたこと

背景や根拠まで確認しますか？

調べる

選ぶ

サイト