無料の事前チェックを実行する
Pythonスクリプト、架空のCSV、MITライセンスをダウンロードできます。標準ライブラリだけで動作し、重複列名、必須列、商品コードの空欄、在庫数の異常を確認します。エラー報告には入力値をコピーしません。
python3 csv-import-preflight.py csv-import-preflight.csv同梱の架空CSVで実行した実際の出力です。
row 3: missing_product_code
row 4: invalid_stock
invalid_rows=2コードを先に確認したい場合は、公開GitHubリポジトリのCSVサンプルに同じ独立した事前チェック、架空データ、実行可能なテストがあります。終了コードと、この小さな検査の対象外もREADMEに記載しています。
自社データに使う際は、列名と検証規則を実際のスキーマに置き換えてください。重複するヘッダーを黙って受け入れると、意図しない列の値が取り込まれるおそれがあります。
列マッピングと正規化を分ける
入力列と出力フィールドの対応を明示し、その後で空白除去、数値の範囲確認、日付形式の統一、列挙値の変換を行います。未知の値は推測せずエラーにします。金額の変換には十進数としての扱いが必要です。
正規化した値を行別に検証し、行番号・フィールド・エラーコードを返します。個人情報や機密値をエラーファイルへ複製しない設計が重要です。
検証と本番データへの反映を分離する
無料サンプルは行の事前チェックだけを行い、検証済みデータの出力やデータベース更新はしません。実運用では、検証済み行だけを別ファイルに出し、件数とエラーを確認してから、別の承認・トランザクション処理で反映します。
Mini版と本版の選び方
BuildShelfのCSV Import Validator Miniは、列マッピング、値の正規化、行別バリデーション、ファイル内の重複キー検出、検証済みJSONLと値を含まないエラー報告をまとめたPython CLIソースです。同梱の架空CSVで実行し、検証済み2行、エラー0行を確認しました。GUIやXLSX対応は含みません。
本版はXLSXの制限付き取込、SQLiteステージング、反映・取消、実行履歴と監査を追加します。検証結果を本番へ反映するライフサイクルまで必要なら本版の範囲を確認してください。
ソースコード商品の比較
必要な取込範囲で選ぶ。
購入前に機能、対象外範囲、動作環境、テスト結果、ライセンス、サポート条件を確認できます。
開示：BuildShelfはリンク先のソースコード商品を販売しています。無料スクリプトはMITライセンスで単体利用でき、有料商品の本体コードや顧客データは含みません。