※本記事はアフィリエイト広告(PR)を含みます。
移行の当日にやることは、作業ではありません。判断です。
手順は前日までに全部書いてあり、リハーサルで一度通してあります。当日の仕事は、決めた時刻までに決めた状態になっているかを確かめ、進めるか戻すかを決めることだけです。それができないと、「もう少しで終わりそう」で夜が明けます。
この記事は、自分のデータベースを別の場所へ移して、件数とハッシュで突合し、所要時間を測り、実際に切り戻すところまでをやります。
対象レベル: 中級 / 区分: 必修
この記事でわかること
- 移行方式は3つしかないこと(一括・並行稼働・段階)
- リハーサルで測るのは手順ではなく時間だということ
- 後戻りできなくなる時刻を先に決めること
- データが正しく移ったことを、件数とハッシュで機械的に示す方法
- 移行判定(Go / No-Go)の基準を、当日の空気で決めないやり方
この記事でやること
- 移行方式を選ぶ
- 移行計画とタイムラインを書く(山場①)
- リハーサルを1回通して、所要時間を測る(山場②)
- 件数とハッシュで突合する(山場③)
- 切り戻しを実際にやる
先に知る言葉
この記事で初めて出てくる言葉です。 詳しくは用語集にもまとめてあります。
| 言葉 | 意味 |
|---|---|
| カットオーバー | 新しい環境へ切り替えて、本番として動かし始める瞬間 |
| リハーサル | 本番と同じ手順を、本番前に通しで実施すること |
| 移行判定 | 予定どおり進めてよいかを、決めた基準で判断すること |
| 後戻り限界点 | これを過ぎたら戻せなくなる時刻。先に決めておく |
| 並行稼働 | 新旧の両方を同時に動かして、結果を突き合わせる期間 |
① 移行方式は3つしかない
| 方式 | やり方 | 向く場面 | 弱点 |
|---|---|---|---|
| 一括 | 止めて、移して、切り替える | 小規模。止めてよい時間がある | 戻せる時間が短い |
| 並行稼働 | 新旧を同時に動かし、しばらく突き合わせる | 止められない。正しさが不安 | 二重運用の手間。データが分かれる危険 |
| 段階 | 機能や部署ごとに順に移す | 規模が大きい | 期間が長い。途中の状態が複雑 |
個人開発や小規模なら、迷わず一括です。 並行稼働は「安全そう」に見えますが、両方に書き込みが起きた瞬間に、どちらが正しいのか誰にも分からなくなります。 採るなら「新は読み取りだけ」のように、書き込む側を1つに固定してください。
② 計画とタイムラインを書く
当日に考えることを、当日までに全部潰します。
mkdir -p ~/ops/docs/migration
nano ~/ops/docs/migration/20260920-db.md
# 移行計画 20260920 / appdb を新サーバーへ
| 項目 | 内容 |
|---|---|
| 方式 | 一括(サービス停止あり) |
| 停止時間 | 22:00〜23:00(予定 40 分・上限 60 分) |
| 影響 | 全利用者。投稿・閲覧ともに停止 |
| 実施者 | 自分 / 立会い: なし(1人なので開始と終了を記録で残す) |
## タイムライン(判定点つき)
| 時刻 | 作業 | 判定 |
|---|---|---|
| 21:45 | 事前確認(空き容量・バックアップ・接続) | **NG なら中止**(着手しない) |
| 22:00 | 告知・サービス停止 | — |
| 22:05 | 移行前のバックアップ取得 | 取得できなければ中止して復旧 |
| 22:15 | データ移送・復元 | — |
| 22:35 | **突合(件数・ハッシュ)** | **不一致なら切り戻し** |
| 22:45 | 接続先の切り替え・起動 | — |
| 22:50 | 動作確認(投稿・閲覧・ログイン) | NG なら切り戻し |
| **23:00** | **後戻り限界点** | ここまでに OK が出なければ**戻す** |
| 23:10 | 完了報告 | — |
## 中止・切り戻しの基準(当日に議論しない)
- 22:35 の突合で 1 件でも不一致 → 切り戻し
- 23:00 までに動作確認が通らない → 切り戻し
- 想定外の事象で原因が 15 分で分からない → 切り戻し
## 切り戻し手順(所要 10 分・リハーサルで実測済み)
1. 新環境を停止する
2. アプリの接続先を旧に戻す
3. 旧環境を起動する
4. 動作確認(投稿・閲覧)
## 移行後の確認(翌営業日)
- エラーログに新しい種類のエラーが出ていないこと
- 日次点検が緑であること
- バックアップが新環境で取得できていること
「後戻り限界点」を書くのが、この計画で一番大事です。 これが無いと、うまくいかないまま時間だけが過ぎ、戻す時間すら無くなってから戻す判断をすることになります。手順書に「中断する判断」を書いたのと、同じ考え方です。
③ リハーサルで測るのは、時間
リハーサルの目的は「できるか」ではありません。「何分かかるか」です。 できることは分かっているので、停止時間に収まるかどうかを確かめます。
# 練習用のデータを作る(本番想定の件数まで増やす)
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS appdb_old;"
mysql -u root -p appdb_old -e "
CREATE TABLE posts (id INT AUTO_INCREMENT PRIMARY KEY, body VARCHAR(200), created_at DATETIME);
INSERT INTO posts (body, created_at)
SELECT CONCAT('post-', n), NOW() - INTERVAL n MINUTE FROM
(SELECT (a.N + b.N*10 + c.N*100 + d.N*1000 + e.N*10000) AS n
FROM (SELECT 0 AS N UNION SELECT 1 UNION SELECT 2 UNION SELECT 3 UNION SELECT 4
UNION SELECT 5 UNION SELECT 6 UNION SELECT 7 UNION SELECT 8 UNION SELECT 9) a
CROSS JOIN (SELECT 0 AS N UNION SELECT 1 UNION SELECT 2 UNION SELECT 3 UNION SELECT 4
UNION SELECT 5 UNION SELECT 6 UNION SELECT 7 UNION SELECT 8 UNION SELECT 9) b
CROSS JOIN (SELECT 0 AS N UNION SELECT 1 UNION SELECT 2 UNION SELECT 3 UNION SELECT 4
UNION SELECT 5 UNION SELECT 6 UNION SELECT 7 UNION SELECT 8 UNION SELECT 9) c
CROSS JOIN (SELECT 0 AS N UNION SELECT 1 UNION SELECT 2 UNION SELECT 3 UNION SELECT 4
UNION SELECT 5 UNION SELECT 6 UNION SELECT 7 UNION SELECT 8 UNION SELECT 9) d
CROSS JOIN (SELECT 0 AS N UNION SELECT 1 UNION SELECT 2 UNION SELECT 3 UNION SELECT 4
UNION SELECT 5 UNION SELECT 6 UNION SELECT 7 UNION SELECT 8 UNION SELECT 9) e
) t;"
mysql -u root -p appdb_old -e "SELECT COUNT(*) FROM posts;"
時間を測りながら通す
time mysqldump -u root -p --single-transaction --routines --triggers appdb_old > /tmp/appdb.sql
ls -lh /tmp/appdb.sql
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS appdb_new;"
time mysql -u root -p appdb_new < /tmp/appdb.sql
real 0m2.108s ← 取得
real 0m6.742s ← 復元
| 測るもの | なぜ |
|---|---|
| 取得と復元の時間 | 停止時間に収まるか。ここが計画の根拠になる |
| ファイルの大きさ | 転送時間と空き容量に効く |
| 手順の抜け | 書いていない前提(権限・文字コード)が必ず出てくる |
| 切り戻しの時間 | 後戻り限界点を決める根拠 |
10 万件で 7 秒なら、100 万件では 70 秒ではありません。 索引の作り直しがあるので、たいていそれ以上に伸びます。 本番と同じ件数で測るのが原則で、できないなら件数を変えて 2 回測り、伸び方を見ます。 計算量の回でやった「測ってから言う」が、そのまま効きます。
リハーサルの移行先に、手元の VM ではなく実際に別の場所を使いたいなら、VPS を短期間だけ借りる手があります。さくらのVPS
はクレジットカード払いなら全プラン 2 週間無料で試せます(2026-11 時点)が、お試し中は外向き通信が 10Mbps に制限されるので、転送にかかった時間を本番の見積もりにそのまま使うことはできません。解約しないと自動で本登録になり最低利用期間も 3 ヶ月あるので、「後戻り限界点」と同じく解約の期限を先に決めておくとよいでしょう。
④ 突合は、件数とハッシュで
「入りました」では確認になりません。 機械が判定できる形にします。
件数を、テーブルごとに比べる
for db in appdb_old appdb_new; do
echo "== $db"
mysql -u root -p -N -e "
SELECT TABLE_NAME, TABLE_ROWS FROM information_schema.TABLES
WHERE TABLE_SCHEMA='$db' ORDER BY TABLE_NAME;"
done
information_schema の件数は概算です。 判定に使うなら、必ず COUNT(*) で数えてください。
for db in appdb_old appdb_new; do
echo -n "$db: "
mysql -u root -p -N -e "SELECT COUNT(*) FROM $db.posts;"
done
中身が同じことを、ハッシュで示す
件数が同じでも、中身が同じとは限りません。 決まった順に並べて出力し、そのハッシュを比べます。
dump_hash() {
mysqldump --defaults-extra-file="$HOME/.dump.cnf" -u root --no-create-info --skip-comments \
--order-by-primary --complete-insert "$1" | md5sum | cut -d' ' -f1
}
read -s -p "MySQL パスワード: " MYSQL_PWD; echo
( umask 077; printf '[client]\npassword=%s\n' "$MYSQL_PWD" > "$HOME/.dump.cnf" ) # コマンドラインに出さないため
echo "old: $(dump_hash appdb_old)"
echo "new: $(dump_hash appdb_new)"
old: 3f9a1c7e5b2d84c6a0e17f3b9d2c5a48
new: 3f9a1c7e5b2d84c6a0e17f3b9d2c5a48
| 指定 | なぜ要るか |
|---|---|
--skip-comments | 出力のコメントに日時やデータベース名が入ると、中身が同じでもハッシュが変わる(--skip-dump-date では日時しか消えない) |
--order-by-primary | 並び順を固定する。順番が違うだけで不一致になるのを防ぐ |
--no-create-info | 定義ではなくデータだけを比べる |
--complete-insert | 列名を明示して、列順の違いに強くする |
一致すれば「同じデータが入った」と機械的に言えます。 目視で数件だけ見て納得するのと、まったく重みが違います。移行判定でこれ以上の根拠はありません。
わざと壊して、突合が効くことを確かめる
mysql -u root -p appdb_new -e "UPDATE posts SET body='changed' WHERE id=1;"
echo "old: $(dump_hash appdb_old)"
echo "new: $(dump_hash appdb_new)" # ← 変わっていれば、検査が効いている
「一致した」だけでは、検査が動いていることの証明になりません。 1 件変えて不一致になることまで見て、はじめて信用できます。
⑤ 切り戻しを、実際にやる
切り戻しは、書いてあるだけでは使えません。 リハーサルで必ず通します。
# 新環境で問題が起きたと仮定して、旧へ戻す
time bash -c '
sudo systemctl stop app 2>/dev/null
sed -i "s/appdb_new/appdb_old/" ~/hitokoto/.env # 接続先を戻す
sudo systemctl start app 2>/dev/null
'
grep DB_NAME ~/hitokoto/.env
この real が、後戻り限界点を決める根拠になります。 切り戻しに 10 分かかるなら、停止時間の終わりの 10 分前が限界点です。
| 戻せるもの | 戻せないもの |
|---|---|
| 接続先の切り替え | 新環境に入った新しいデータ |
| 設定ファイル | 外部へ送ったメール・通知 |
| アプリの版 | 他システムへ渡した連携データ |
切り替えたあとに利用者が投稿したデータは、旧環境には存在しません。 だから「切り戻せる時間」は、利用者に開放する前までです。開放したあとの切り戻しは、データの手作業の移し替えを伴う別作業になります。
⑥ 移行判定(Go / No-Go)
判定は、当日の空気ではなく、前日までに決めた基準で行います。
| タイミング | 判定すること | NG のとき |
|---|---|---|
| 前日 | リハーサル完了・手順の凍結・バックアップ確認 | 延期(当日に慌てて準備しない) |
| 当日 着手前 | 空き容量・接続・関係者の待機 | 着手しない |
| 突合後 | 件数とハッシュが一致 | 切り戻し |
| 後戻り限界点 | 動作確認が全部通った | 切り戻し |
一番よくある失敗は、前日の判定を飛ばすことです。 「リハーサルは当日やればいい」で始めると、想定外が出た時点でもう戻る時間がありません。 前日に一度通しておけば、当日の想定外はほとんど無くなります。
完成の判定
| # | 確かめること | 合格の形 |
|---|---|---|
| 1 | 方式を選んだ理由が言える | 止められる時間と、書き込み先の数で説明できる |
| 2 | 所要時間を実測した | 取得・復元・切り戻しの real が出ている |
| 3 | 後戻り限界点がある | 切り戻し時間から逆算した時刻が書いてある |
| 4 | ハッシュが一致した | old と new の md5 が同じ |
| 5 | 1件変えたら不一致になった | 検査が効いていることを確認した |
つまずいたところ
ハッシュが毎回変わる
--skip-comments を付けていません。出力のコメントに、末尾の日時や先頭のデータベース名が入るので、内容が同じでも別のハッシュになります。
件数は同じなのに、ハッシュが違う
並び順か、文字コードか、時刻の扱いです。
mysql -u root -p -e "SHOW VARIABLES LIKE 'character_set_%';"
mysql -u root -p -e "SELECT @@global.time_zone, @@session.time_zone;"
移行元と先で文字コードやタイムゾーンが違うと、中身が変わります。 文字コードの回で見た「二重エンコード」と、日付の回で見た「9時間ずれる」が、移行では同時に出てきます。
復元が本番想定の時間で終わらない
# 復元中だけ、コミットごとのログのディスク書き込みを緩める(大きなデータで効く)
mysql -u root -p appdb_new -e "SET GLOBAL innodb_flush_log_at_trx_commit=2;"
# 終わったら必ず 1 に戻す
mysql -u root -p appdb_new -e "SET GLOBAL innodb_flush_log_at_trx_commit=1;"
速くする設定は、安全性を落としています。 戻し忘れると、障害時にデータを失います。戻す作業を手順書に必ず書いてください。
切り替えたのに、古いほうを見ている
アプリが接続を保持しています。設定を変えたら、必ず再起動して確かめてください。 DNS で切り替える場合は、TTL のぶんだけ古い宛先へ行き続けます(Route 53 の回と同じ話です)。
後片づけ
mysql -u root -p -e "DROP DATABASE appdb_new; DROP DATABASE appdb_old;"
rm -f /tmp/appdb.sql "$HOME/.dump.cnf"
unset MYSQL_PWD
よくある質問
- 並行稼働のほうが安全ではありませんか
- 書き込みが両方に発生しない構成なら安全です。新旧の両方が更新を受け付けると、どちらが正しいかを人が判断することになり、かえって危険になります。採用するなら、新環境は読み取り専用にして結果を比較するだけ、というように書き込み先を1つに固定してください。二重運用の手間も無視できないので、小規模なら一括のほうが確実です。
- リハーサルは本番と同じデータでやるべきですか
- 件数は本番相当にしてください。所要時間を測るのが目的なので、件数が違うと意味がありません。ただし個人情報を含む場合は、値をマスクしたうえで件数だけ合わせます。本番データをそのまま検証環境へ持ち込むと、そこが新しい漏洩経路になるためです。
- 後戻り限界点を過ぎたら、どうするのですか
- 進めるしかありません。だからこそ、その時刻までに判断できる材料を揃えておきます。限界点を過ぎても戻したい状況になった場合は、切り戻しではなく障害対応として扱い、暫定策で影響を抑えながら復旧を目指します。これは計画の失敗なので、必ず記録に残して次に生かしてください。
- ハッシュが一致すれば、移行は成功と言えますか
- データが同じであることは言えますが、動くことは別に確かめる必要があります。文字コードやタイムゾーン、権限、接続数の上限といった環境側の違いは、データが同じでも障害になります。ハッシュの一致は移行判定の必要条件であって、十分条件ではありません。動作確認とセットにしてください。
- 個人開発でも、ここまでやる必要がありますか
- タイムラインと後戻り限界点、突合の3つだけは、規模によらず効きます。所要時間を測っておけば深夜作業を避けられますし、ハッシュの突合は数行で済みます。逆に、判定会議や立会いのような体裁は、人数が増えてから足せば十分です。省いてよいのは形式で、判断の材料ではありません。
まとめ — 理解できたこと
- 当日の仕事は作業ではなく判断。 手順とリハーサルは前日までに終える
- リハーサルで測るのは「できるか」ではなく「何分か」
- 後戻り限界点は、切り戻しの実測時間から逆算する
- 突合は件数とハッシュで。 1 件変えて不一致になることまで確かめる
- 切り戻せるのは、利用者に開放する前まで。 開放後は別作業になる
- 文字コードとタイムゾーンは、移行で同時に牙を剥く
参考リンク
- MySQL 公式 —
mysqldumpのオプション - IPA — システム移行の進め方(計画と判定)
次に読む
この記事は 【第8段階】深掘り の 29 / 30 本目です。
| 記事 | |
|---|---|
| ← 前の記事 | EOLと保守契約 — サポート切れで起きることと版の棚卸し |
| → 次の記事 | バックアップの復元試験 — 戻して件数と集計で照合する |
上から順に読めば積み上がるように並べています。 飛ばしても構いませんが、詰まったら前の回に戻ってください。
全体の順路は はじめに にあります。

コメント