EC-CUBEのCSV自動バックアップ｜在庫・注文・出荷データの保存と運用設計

この記事でわかること
EC-CUBEの在庫・注文・出荷情報を定期的にCSVへ出力し、ZIPで保存するカスタマイズ事例を紹介します。管理画面からのダウンロードに加え、サイト全体のバックアップとの違い、保存期間・権限・出力失敗時の対応を整理します。

CSVの自動バックアップを検討する際は、「どの情報を、何のために残し、あとでどう使うか」を先に決めます。業務データの確認や外部システムとの連携に使うCSVと、障害時にサイト全体を復旧するためのバックアップでは、必要な内容と手順が異なります。

在庫・注文・出荷CSVを定期保存したカスタマイズ事例

サンクユーでは、EC-CUBEから複数のCSVを定期的に出力し、管理画面から過去のファイルをダウンロードできる機能を実装しました。掲載事例の仕様は次のとおりです。

1時間・30日という条件は、この事例の運用に合わせたものです。EC-CUBEの標準設定や、すべてのサイトに推奨する期間を示すものではありません。

管理画面に「バックアップ管理」を追加

システム設定のメニューに、保存したZIPを確認するための「バックアップ管理」を追加しました。

日時を選んでZIPをダウンロード

保存されたZIPが日時別に一覧表示されます。日時のリンクから対象ファイルをダウンロードでき、管理画面からの削除にも対応しています。

ZIP内に3種類のCSVをまとめる

ダウンロードしたZIPを解凍すると、在庫・注文・出荷情報のCSVを取得できます。掲載画面では、order・product・shippingで始まるファイル名に日時を付けています。

画像は過去の個別実装の画面です。現在のEC-CUBEのバージョンや既存改修によって、画面構成・対応方法は異なります。以降は、同様の仕組みを導入・改修する際の確認事項です。

CSVの保存とサイト全体のバックアップの違い

「バックアップ」という言葉だけでは、どこまで戻せるのかが曖昧になります。今回の事例で保存しているのは、指定した業務情報を出力したCSVです。プログラムや商品画像、データベース全体をまとめたものではありません。

EC-CUBEの公式「4.3 本体バージョンアップ」手順でも、作業前にインストール先のファイル一式とデータベース全体をバックアップするよう案内されています。本記事の3種類のCSVを保存するだけでは、サイト全体の復旧準備にはなりません。

参照：EC-CUBE公式開発ドキュメント「4.3 本体バージョンアップ」

また、確認したEC-CUBE 4.3.1-p1版の公式マニュアルでは、CSVの出力項目と並び順を設定する機能が説明されています。項目の設定に加え、定期実行・ZIP化・履歴一覧・期限による削除を行う仕組みが利用環境にあるかは、別途確認します。独自に追加した項目の出力も確認が必要です。

参照：EC-CUBE公式マニュアル「CSV出力項目設定」

出力対象と保存する時点を決める

全件・差分と、データを結び付けるIDを整理する

全件を毎回残すのか、前回から変更された分だけを残すのかで、必要な容量や後から確認できる内容が変わります。差分を使う場合は、注文の変更・キャンセル・削除などをどのように扱うかも決めます。

在庫なら商品・規格を識別するIDや商品コード、注文なら注文IDや明細ID、出荷なら配送を識別するIDなど、利用目的に応じて必要な項目を揃えます。1つの注文に複数商品・複数配送先がある場合も、データの対応関係を確認できる形にします。

取引先別価格や独自の受注項目があるBtoB-ECでは、標準項目だけで業務上必要な情報が揃うかを確認します。保存する項目と、外部システムへ渡す項目を分ける設計も検討します。

実行日時と抽出基準を明確にする

ファイル名の日時が「処理を始めた時刻」なのか「対象データの基準時刻」なのかを決め、使用するタイムゾーンも揃えます。複数のCSVを作成している間に受注や在庫が更新される場合は、どの時点の状態として扱うかを検討します。

1時間ごとに保存しても、その間に起きた変更をすべて履歴として残せるとは限りません。途中の変更経緯まで必要であれば、変更履歴を残す仕組みも含めて考えます。実行間隔は、必要な確認頻度、データ量、受注処理への負荷を踏まえて決めます。

掲載事例の全件・差分の区別や、複数CSVの抽出時点を揃える内部処理は、本記事では確定していません。導入時に個別に確認する設計項目です。

保存期間・保存先・利用できる担当者を決める

保存期間は、業務で過去データを確認する期間と、ファイルの容量を踏まえて決めます。掲載事例は30日間の保管ですが、ダウンロードしたファイルや別の保存先に複製したデータの期限は、それぞれ管理する必要があります。

注文・出荷CSVには、出力項目によって氏名・住所・連絡先などが含まれます。一般公開されない場所に保存し、必要な担当者だけが取得できる構成を検討します。管理画面のメニューを隠すだけでなく、ファイルを直接取得する経路でも権限を確認します。

OWASPのセキュリティガイドでも、バックアップやアーカイブをWeb経由で公開してしまうことによる情報漏えいが取り上げられています。ZIPに圧縮すること自体を、閲覧制限の代わりにはしません。

参照：OWASP「バックアップ等のファイルに含まれる機密情報の確認」（英語）

• ダウンロードできる担当者と、削除できる担当者の範囲
• 誰がいつ取得・削除したかを確認する記録
• 保存期間を過ぎたファイルと、処理途中の一時ファイルの削除
• 保存先の空き容量と、データ増加に応じた見直し
• 担当者のパソコンや共有フォルダーに取得した後の保管・削除ルール

本番サーバー内だけに保存する場合、同じサーバーの障害で元データと保存ファイルの両方を失う可能性があります。障害への備えにも使うなら、別の保存先への複製と、そのアクセス権限・保管期限・取り出し方を検討します。これらの保存先構成や操作記録は、掲載事例で実装済みとするものではありません。

出力失敗と再利用に備える運用

保存できたことを確認し、失敗を見つける

自動処理を設定した後は、予定どおり実行され、必要なCSVが揃っていることを確認できるようにします。ZIPが作成されていても、中身が不足していたり、対象外のデータを出力していたりする可能性があります。

最終成功日時、出力件数、ファイルサイズ、エラーの有無を確認する方法を決めます。対象データが0件だった正常な処理と、失敗による空ファイルも区別します。容量不足や処理の停止を誰に知らせ、誰が対応するかまで整理します。

途中まで作成したファイルを完了済みとして扱わないこと、処理が長引いた場合に次の実行と重ならないことも検討します。失敗後に再出力すると、その時点では元データが変わっている場合があります。過去の時点と同じ内容を再現できるかを確認し、再出力した日時と対象範囲を記録します。

CSVを開く・取り込むところまで確認する

定期的にZIPを取得し、解凍できること、CSVの項目・件数・対象日時が意図どおりであることを確かめます。表計算ソフトで編集する場合は、商品コードの先頭ゼロや日付の形式などが変わらないよう、元ファイルを残して確認します。

保存用CSVと、取り込み先が受け付けるCSVは、同じ形式とは限りません。列の並び、文字コード、ID、必須項目、更新対象を確認し、検証環境で取り込み結果を確かめます。過去の在庫数や受注状態で現在の情報を上書きしないよう、反映範囲と手順を決めます。

外部システムとの連携に使う場合は、送信したことと取り込みが成功したことを分けて確認します。再実行で同じ注文や出荷を重複登録しないための識別方法も必要です。今回の掲載事例は、CSVの自動保存と取得を紹介するもので、外部システムへの自動取り込みやCSVからの自動復元を示したものではありません。

CSV自動バックアップの相談前に整理したいこと

サンクユーでは、EC-CUBEと販売管理・会計などの業務システムとのCSV連携に対応してきました。出力項目やファイル形式は、企業ごとの業務と取り込み先に合わせて整理します。

• EC-CUBEのバージョン、既存のCSV出力機能・プラグイン・独自改修
• 保存したいデータと、その利用目的（確認・連携・復旧のどこまでか）
• 出力対象の条件、全件・差分の扱い、必要なIDと項目
• 実行する時間帯・間隔、保存期間、想定するデータ量
• 保存先、ダウンロード・削除権限、失敗時に対応する担当者
• 外部システムの取り込み仕様と、サイト全体のバックアップの実施状況

サンクユーでは、EC-CUBE構築・カスタマイズやBtoB-EC構築のご相談に対応しています。現在のCSVサンプルや作業手順をもとに、定期出力・保管・管理画面・外部連携の対応範囲を整理します。

CSV自動バックアップに関するよくある質問