データ移行約5分で読めます

データ移行の引継ぎ|対応表と手順の保存

データ移行の引継ぎを表したイメージ
記事の内容を表したイメージ(AI生成)

データ移行を一度やり遂げたあと、「次に同じ作業をする人が困らないように残しておく」という引継ぎの準備は、締切後の疲れた状態で後回しになりがちです。しかし半年後に同じ移行が必要になったとき、対応表も手順も残っていなければ、また最初から調べ直す羽目になります。

この記事では、CSVを使ったデータ移行を引き継ぐために何を保存すべきかを整理します。具体的には「列の対応表(マッピング表)」「加工ルールの記録」「実行手順のメモ」の三点セットを、次の担当者が単独で再現できる形にまとめる方法を説明します。移行ツールの使い方や変換関数の書き方は他の記事に譲り、この記事は「作業後に何をどう残すか」に絞ります。


引継ぎ資料が薄いと何が起きるか

データ移行の引継ぎでよく起きる問題は「何をしたかは残っているが、なぜそうしたかが残っていない」という状態です。たとえば、移行後のCSVを見ると旧システムの「得意先コード」が新システムでは「顧客ID」に変わっています。列名が変わったことはわかっても、コードの採番ルールが変わったかどうか、空欄があった場合にどう処理したか、は完成ファイルを見ただけでは判断できません。

担当者が変わったときだけでなく、同じ人が半年後に再実行するときも、記憶は薄れています。「対応表と手順を書く」作業は自分自身への引継ぎでもあります。


保存すべき三点セットの概要

引継ぎ資料として最低限必要なのは次の三つです。

  1. 列の対応表(マッピング表):旧システムの列名と新システムの列名の対応、型の変換有無
  2. 加工ルールの記録:値の変換・空欄の扱い・除外した行の条件など、判断が入ったルール
  3. 実行手順のメモ:ファイルを開く順番、ツールの設定、出力の確認方法

三点とも一つのスプレッドシートにまとめておくと、ファイルを探す手間が減ります。シート1に対応表、シート2に加工ルール、シート3に手順、という構成が管理しやすいです。


列の対応表(マッピング表)の作り方

マッピング表は、旧システムと新システムのCSVを並べて、列ごとに対応を記録する表です。以下は架空の例です(架空の例です)。

表は横にスクロールできます

旧CSVの列名新CSVの列名型の変換備考
得意先コード顧客IDなし桁数・形式とも同じ
登録日登録日時ありYYYY/MM/DD → YYYY-MM-DD 00:00:00
担当者名担当者氏名なし列名のみ変更
区分コード(なし)—新システムに該当列なし、移行対象外
(なし)作成者ID—新システム固定値「admin」を一括入力

表の「備考」列が重要です。「列名だけ変わった」のか「値の形式も変わった」のか、「新システムに存在しない列をどう扱ったか」を一行でも書いておくと、次の担当者がファイルを見比べる時間を大幅に短縮できます。

列が多い場合は、変換が発生しない単純な対応をまとめて一行に記載し、加工が必要だった列だけ個別に書くと表が読みやすくなります。


加工ルールの記録:判断が入った箇所を重点的に残す

マッピング表が「何と何が対応するか」の地図なら、加工ルールの記録は「どう変換したか」の説明書です。特に以下の三種類の判断は、必ず記録しておく必要があります。

値の変換ルール 旧システムの「区分」列に「1」「2」「3」が入っており、新システムでは「A」「B」「C」に対応させた、といった変換です。対応表を別途作った場合はそのファイル名も記載しておきます。

空欄・異常値の扱い 空欄をそのまま渡した場合と、「0」や「未登録」に置き換えた場合では、新システム側の動作が変わることがあります。「〇〇列が空欄だった行は除外した」「〇〇列の空欄は''(空文字)のまま渡した」のどちらかを明記します。

除外した行・追加した行 移行対象外として除外した行の条件(例:「退会済みフラグが1の行は対象外」)と、新システム用に追加で作成した行の根拠を記録します。

加工ルールの記録は箇条書きで十分です。以下は架空の例です(架空の例です)。

  • 「登録日時」列:旧CSV の YYYY/MM/DD を YYYY-MM-DD 00:00:00 形式に変換。変換にはExcelのTEXT関数を使用(シート3「手順」参照)
  • 「顧客区分」列:旧システムの値1→A、2→B、3→C に置換。対応表は別ファイル「区分対応表.xlsx」に保存
  • 「退会フラグ」が「1」の行はすべて除外。除外後の件数は元データ1,200行から1,147行
  • 「作成者ID」列は新システムの要件により全行「admin」を入力(固定値)

実行手順のメモ:再現できる粒度で書く

手順のメモは「自分が一人でゼロから再実行できるか」を基準に書きます。「変換作業を行う」ではなく「〇〇.xlsxの変換シートを開き、A列に元CSVを貼り付け、E列の結果をコピーして新CSVに貼り付ける」という粒度が目安です。

手順のメモに含めると良い項目は以下の通りです。

  • 使ったファイルの名前と保存場所(共有フォルダのパスやドライブ名)
  • 作業前に取るバックアップの方法(ファイルのコピー先、命名規則)
  • 作業の順番(どのファイルを先に開くか、どの順番で処理するか)
  • 完了確認の方法(件数チェック、特定列のサム、目視確認の箇所)
  • よくある失敗と対処(例:文字コードがUTF-8でないと文字化けする、保存時にExcel形式にしないよう注意)

「画面の表示は版や設定により異なります」ので、メニュー名や設定値は使っているツールの公式ヘルプで最新状態を確認してください。手順メモにはその確認先(ツール名・公式ヘルプの名称)を添えておくと安心です。

なお、名簿や顧客データを含むCSVは、外部サービスや生成AIに入れる前に情報の取り扱いルールを確認してください。引継ぎ資料にも「このファイルには個人情報が含まれます」と一行添えておくと、次の担当者への注意喚起になります。


資料を渡すときの確認チェック

完成した引継ぎ資料を渡す前に、次の四点を確認すると漏れを防げます。

  • マッピング表に「新旧どちらにも存在しない列」が記録されているか
  • 加工ルールに、値を変換した列と除外した行の条件が書かれているか
  • 手順のメモに、バックアップの手順と完了確認の方法が含まれているか
  • 資料と実際のCSVのヘッダー行が一致しているか(最後に元ファイルと見比べる)

四点すべてに問題がなければ、次の担当者に渡せる状態です。資料を渡した後に「この列の扱いはどうすればよいか」という質問が返ってきた箇所は、次回の更新時に補足として追記しておくと資料が育ちます。


次の行動

まず手元の移行作業が終わったタイミングで、上記の三点セット(対応表・加工ルール・手順)を一つのスプレッドシートに書き出してください。時間がない場合は加工ルールだけでも先に箇条書きにしておくと、記憶が薄れる前に重要な判断を残せます。作成した資料は元のCSVと同じフォルダに保存し、ファイル名に作業日を入れておくと、後から対象の移行作業と紐付けて探せます。

この記事の本文はAI(Claude)が執筆しました。画面の表示や操作名は、アプリの版や設定によって異なります。実際の操作の前に元のファイルを複製し、公式のヘルプで最新の情報を確認してください。

記事の誤り・ファイルの不具合を知らせる · 修正記録

記事一覧へ