結論
マイグレーション(migration)とは、システムやデータを別の環境へ移すことです。IT では主に3つの意味で使われます。①DB のテーブル構造の変更を番号つきのファイルで管理する「DB マイグレーション」、②以前のシステムを新しい OS・言語・機器へ移す「システムマイグレーション」、③オンプレミスからクラウドへ移す「クラウドマイグレーション」です。
この記事でわかること
- 3つの意味の違いと、リプレース・コンバージョン・アップグレードとの違い
- DB マイグレーションの仕組み(履歴の表・up と down)を SQLite と Alembic で動かした出力
- システム移行・クラウド移行の進め方(手法・7つのR・切り戻し)と、20万件のデータ移行の件数照合
この記事で実際に動かしたもの:Python で書いた小さなマイグレーションの仕組み(SQLite)、Alembic 1.20.1 の upgrade・downgrade・履歴の表示とエラー、20万件の顧客データを変換して移す移行と件数・ハッシュの照合です。
flowchart TD
A[マイグレーション] --> B[DB<br>構造変更]
A --> C[システム<br>OS・言語]
A --> D[クラウド<br>移行]
よく調べられることの答えを先にまとめます。
| 知りたいこと | 答え | 詳しい節 |
|---|---|---|
| マイグレーションとは | システムやデータを別の環境へ移すこと。英語の migration(移住・移動)から | マイグレーションとは |
| マイグレーション IT での意味 | DB の構造変更の管理・システム移行・クラウド移行の3つが中心 | IT での3つの意味 |
| リプレースとの違い | リプレースは作り直して置き換える。マイグレーションは今の資産を生かして移す | リプレースとの違い |
| DB マイグレーションとは | テーブルの変更を番号つきファイルにし、どこまで適用したかを DB の表に記録する仕組み | DB マイグレーションとは |
| up と down の意味 | up は変更を当てる処理、down は取り消す処理 | 自作して動かす |
| 主なツール | Rails・Laravel・Django・Alembic・Flyway・Prisma など | 主なツールの比較 |
| クラウド移行の手法 | AWS の「7つのR」(リホスト・リプラットフォームなど) | クラウドマイグレーション |
| システム移行の進め方 | 計画→リハーサル→切り替え→切り戻しの判断、の順 | 進め方 |
確認環境:Ubuntu 24.04.5 LTS・Python 3.13.18・SQLite 3.53.1(Python 標準の sqlite3)。作業用の仮想環境に Alembic 1.20.1(SQLAlchemy 2.1.8)を入れ、SQLite のファイルに対して実行しました。自作のマイグレーションの仕組みとデータ移行の照合は Python の標準ライブラリだけで書いています。Rails・Laravel・Django・Flyway・Prisma は動かしておらず、各公式ドキュメントの記載で書いています。システム移行・クラウド移行の手法は AWS の公式(Prescriptive Guidance)と辞書・用語辞典で確かめた範囲です(確認日 2026年11月16日)。
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「マイグレーションとは|意味とDB・システム・クラウド移行の違い・進め方」
マイグレーションとは(意味と語源)
この節では、マイグレーションという言葉のもとの意味と、IT での意味が分かります。
マイグレーションは、英語の migration をカタカナにした言葉で、もとの意味は「移住・移動」です。人や動物がある場所から別の場所へ移ることを指し、鳥の渡りや人の大きな移動にも使われます。
IT では「今あるもの(データ・プログラム・システム)を、別の環境へ移すこと」の意味になります。デジタル大辞泉には「移住。移動」と並んで「ハードウエアやOSなどが異なる情報システム間で、データやプログラムを移行すること」と載っています。IT 用語辞典の e-Words は、ソフトウェアやシステム、データなどを別の環境へ移したり、新しい環境へ切り替えたりする意味で使われることが多い、と説明しています。
- 読み方:マイグレーション。略して「マイグレ」と呼ぶ人もいます。
- 日本語にすると:「移行」がいちばん近い言葉です。「データ移行」「システム移行」は、それぞれデータマイグレーション・システムマイグレーションとほぼ同じ意味です。
- IT 以外の意味:生物の移動(細胞の移動など)、地震探鉱で地下の構造を正しい位置に直す処理、電子部品の金属が移動する現象(エレクトロマイグレーション)などもマイグレーションと呼ばれます。この記事では IT の意味だけを扱います。
ITでのマイグレーションの3つの意味(DB・システム・クラウド)
この節では、IT の会話で「マイグレーション」と言われたときに、どの意味かを見分ける方法が分かります。
開発者どうしの会話なら DB マイグレーション、会社の計画や提案書ならシステム移行かクラウド移行の意味であることが多いです。同じ言葉でも、かかる時間も関わる人もまったく違います。
| 意味 | 何を移す・変えるか | よく出る場面 | 期間の目安 |
|---|---|---|---|
| DB マイグレーション | テーブルの追加・列の追加など、DB の構造(スキーマ) | Rails・Laravel・Django などの開発。「マイグレーションを流す」 | 1回は数秒〜数分 |
| システムマイグレーション | OS・言語・機器・ミドルウェア。以前のシステムを新しい環境へ | 保守期限が近いシステムの移行計画 | 数か月〜数年 |
| クラウドマイグレーション | 自社のサーバー(オンプレミス)からクラウドへ | AWS・Azure・Google Cloud への移行 | 数か月〜 |
| データマイグレーション | データそのもの(形式の変換を含む) | システム移行の一部、DB の製品の乗り換え | システム移行に含まれる |
| 仮想マシンのマイグレーション | 動いている仮想マシンを別の物理サーバーへ | 仮想化基盤の保守(ライブマイグレーション) | 数秒〜数分 |
e-Words では、仮想マシンを止めて移す方式をクイックマイグレーション(コールドマイグレーション)、動かしたまま移す方式をライブマイグレーション(ホットマイグレーション)と説明しています。以前のシステムを新しい環境で作り直して移すことは、特に「レガシーマイグレーション」と呼ばれます。
1「マイグレーションファイルを作って」
開発の会話。テーブルや列を変えるときの、番号つきのファイルを作る意味です。
2「基幹システムのマイグレーション」
以前のシステムを新しい OS や言語へ移す計画の意味。予算とスケジュールを伴います。
3「クラウドへのマイグレーション」
自社のサーバーで動くものをクラウドへ移す意味。どこまで作り変えるかで手法が分かれます。
マイグレーションとリプレース・コンバージョン・アップグレードの違い
この節では、似た言葉との違いが一覧で分かります。
違いは「今の資産をどれだけ生かすか」です。マイグレーションは今のプログラムやデータを生かして新しい環境へ移すこと、リプレースは新しいシステムに置き換えることを指して使われるのが一般的です。
| 言葉 | 意味 | 今のプログラムは | 例 |
|---|---|---|---|
| マイグレーション | 今の資産を生かして別の環境へ移す | 生かす(直しながら移す) | 同じ業務のプログラムを新しい OS・DB へ移す |
| リプレース | 新しいシステム・製品に置き換える | 使わない(作り直すか製品に替える) | 自社開発の仕組みをクラウドのサービスに替える |
| コンバージョン | プログラムやデータを別の形式・言語に変換する | 変換して使う | COBOL のプログラムを Java に変換する |
| アップグレード | 同じ製品の新しい版にする | そのまま使う(互換の範囲で) | PostgreSQL 17 から 18 へ上げる |
| モダナイゼーション | 今のシステムを今の技術・設計に近づける取り組みの総称 | 段階的に作り変える | 大きな1つのプログラムをサービスに分ける |
コンバージョンはマイグレーションの手段の1つとして扱われることもあり、境目は会社や文書によって少しずつ違います。e-Words は、同じソフトの旧版から新版への入れ替え(アップグレード)を新環境への移行として含める場合もある、と書いています。提案書や計画書で使うときは、冒頭で「この文書のマイグレーションは何を指すか」を1行で決めておくと、読み違いが減ります。
マイグレーション(移す)
業務の流れ・画面は大きく変えない
今のプログラム・データを生かす
確かめるのは「前と同じ結果になるか」
リプレース(置き換える)
業務の流れも見直せる
新しく作るか製品を選ぶ
確かめるのは「必要な機能がそろうか」
DBマイグレーションとは(スキーマの変更をバージョンで管理する仕組み)
この節では、開発で使う DB マイグレーションが何を解決するのかと、仕組みの3つの部品が分かります。
DB マイグレーションは、テーブルの変更を「番号つきのファイル」にし、どこまで当てたかを DB の中の表に記録する仕組みです。Rails のガイドは、マイグレーションを「データベーススキーマが長期にわたって進化を安定して繰り返せるようにするための仕組み」と説明しています。Laravel のドキュメントは「データベースのバージョン管理のようなもの」と書き、ソースコードを取り込んだ仲間に「自分の DB に手で列を足して」と頼んだことがあるなら、それがマイグレーションの解決する問題だ、と説明しています。
- 1マイグレーションファイル1回分の変更(テーブル作成・列の追加など)を書いたファイル。名前に番号か日時が付き、順番が決まる
- 2up と downup は変更を当てる処理、down は取り消す処理。Rails の change のように、取り消しを自動で導くものもある
- 3履歴の表DB の中に「どの番号まで当てたか」を記録する表。Rails は schema_migrations、Alembic は alembic_version、Laravel は migrations
- 4コマンドまだ当てていないファイルだけを順に実行する。開発者の PC・テスト用・本番の DB が同じ手順で同じ形になる
この仕組みがあると、ファイルは Git でコードと一緒に管理でき、レビューもできます。新しく入った人の PC でも、コマンド1つで本番と同じテーブル構造が作れます。
flowchart TD
V0[空の DB] -->|0001 up| V1[users 表]
V1 -->|0002 up| V2[email 列を追加]
V2 -->|0003 up| V3[orders 表]
V3 -.->|0003 down| V2
DBマイグレーションを自作して動かす(SQLiteとPythonでupとdown)
この節では、DB マイグレーションの中で何が起きているかを、約70行の自作の仕組みで実際に確かめた結果が分かります。
ツールがしていることは「ファイルの一覧」と「履歴の表」を比べ、足りない番号だけを順に実行して記録する、という単純な処理です。それを確かめるため、Python の標準ライブラリだけで小さな仕組みを書きました。マイグレーションファイルは次の3つです。
-- 0001_create_users.sql
-- up
CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL);
-- down
DROP TABLE users;
-- 0002_add_email_to_users.sql
-- up
ALTER TABLE users ADD COLUMN email TEXT;
-- down
ALTER TABLE users DROP COLUMN email;
-- 0003_create_orders.sql
-- up
CREATE TABLE orders (id INTEGER PRIMARY KEY, user_id INTEGER REFERENCES users(id), amount INTEGER NOT NULL);
CREATE INDEX idx_orders_user ON orders(user_id);
-- down
DROP INDEX idx_orders_user;
DROP TABLE orders;
仕組みの中心は、履歴の表を作る部分と、未適用のファイルを1つずつトランザクションの中で実行する部分です。
con = sqlite3.connect(DB, isolation_level=None)
con.execute("""CREATE TABLE IF NOT EXISTS schema_migrations(
version TEXT PRIMARY KEY, name TEXT, checksum TEXT, applied_at TEXT)""")
applied = {r[0]: r for r in con.execute("SELECT * FROM schema_migrations")}
for v, n, up, down, cs in migs: # ファイル名の番号の順
if v in applied:
continue # 当てた番号は飛ばす
try:
con.execute("BEGIN")
for stmt in [s for s in up.split(";") if s.strip()]:
con.execute(stmt)
con.execute("INSERT INTO schema_migrations VALUES(?,?,?,?)", (v, n, cs, now()))
con.execute("COMMIT")
print(f"== {v} {n}: migrated")
except sqlite3.Error as e:
con.execute("ROLLBACK") # 途中で失敗したら全部戻す
print(f"== {v} {n}: FAILED -> rolled back: {type(e).__name__}: {e}")
sys.exit(1)
status(状態の一覧)→ up(適用)→ status → history(履歴の表)→ down(1つ取り消し)の順に実行した出力です。
$ status
0001 pending create_users
0002 pending add_email_to_users
0003 pending create_orders
$ up
== 0001 create_users: migrated
== 0002 add_email_to_users: migrated
== 0003 create_orders: migrated
$ status
0001 applied create_users
0002 applied add_email_to_users
0003 applied create_orders
$ history
0001 | create_users | a42467710b66 | 03:19:11
0002 | add_email_to_users | 7ff7b8c3bd8e | 03:19:11
0003 | create_orders | 6d7958adb9bd | 03:19:11
$ schema
CREATE TABLE orders (id INTEGER PRIMARY KEY, user_id INTEGER REFERENCES users(id), amount INTEGER NOT NULL)
CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, email TEXT)
$ down
== 0003 create_orders: reverted
$ status
0001 applied create_users
0002 applied add_email_to_users
0003 pending create_orders
$ up
== 0003 create_orders: migrated
2回目の up では 0001・0002 は飛ばされ、0003 だけが実行されました。「何回実行しても、足りない分だけが当たる」のが DB マイグレーションの要点です。down は最後に当てた1つだけを戻し、履歴の表からもその行を消しています。
失敗したマイグレーションと履歴の食い違い(トランザクション・チェックサム)
この節では、マイグレーションが途中で失敗したとき、当てたあとのファイルを書き換えたときに何が起きるかが分かります。
途中で失敗したときに DB が「半分だけ変わった」状態にならないかは、DB の製品とツールの設定しだいです。次のファイルは、1文目の列の追加は通り、2文目で失敗するように書いています(既存の行があるのに、既定値なしで NOT NULL の列を足している)。
-- 0004_add_phone_bad.sql
-- up
ALTER TABLE users ADD COLUMN phone TEXT;
ALTER TABLE users ADD COLUMN status TEXT NOT NULL;
$ up
== 0004 add_phone_bad: FAILED -> rolled back: OperationalError: Cannot add a NOT NULL column with default value NULL
exit=1
$ schema
CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT NOT NULL, email TEXT)
$ status
0004 pending add_phone_bad
1文目で足した phone 列も残っていません。SQLite はテーブルの変更(DDL)をトランザクションの中で取り消せるため、0004 全体が無かったことになりました。既定値を付けて書き直すと通ります。
-- 0004_add_status.sql の up: ALTER TABLE users ADD COLUMN status TEXT NOT NULL DEFAULT 'active';
== 0004 add_status: migrated
[(1, 'sato', 's@example.com', 'active'), (2, 'suzuki', None, 'active'), (3, 'tanaka', 't@example.com', 'active')]
Django のドキュメントは、DDL のトランザクションに対応する DB(SQLite と PostgreSQL)では既定で1つのトランザクションの中で実行し、対応しない DB(MySQL・Oracle など)ではトランザクションなしで実行する、と書いています。MySQL について「失敗したら手で変更を戻してからやり直す必要がある」とも書いています。MySQL で1つのファイルに複数の変更を書くと、失敗したときに途中までの変更が残ります。1ファイル1変更にしておくと、戻す範囲が分かりやすくなります。
次に、当てたあとの 0002 のファイルを1文字書き換えて status を見ます。自作の仕組みでは、当てたときのファイルのハッシュ(チェックサム)を履歴の表に残しているので、食い違いが分かります。
$ status
0001 applied create_users
0002 applied add_email_to_users <- checksum mismatch (applied=7ff7b8c3bd8e)
0003 applied create_orders
0004 applied add_status
Flyway も、スキーマ履歴の表でマイグレーションのチェックサムと成否を記録すると公式ドキュメントに書かれています。当てたファイルは書き換えず、直したいときは新しい番号のファイルを足すのが、どのツールでも共通の決まりごとです。
本番に当てたあとで間違いに気づいたとき
まだ誰とも共有していない手元だけのファイルなら、down で戻して書き直してもよい
Alembicで同じことをする(alembic_versionとupgrade・downgradeの出力)
この節では、実際のツールでも前の節と同じ仕組みで動いていることが、Alembic の出力で分かります。
Alembic は Python の SQLAlchemy 用のマイグレーションツールで、履歴は alembic_version という表に「今の番号」1行だけを持ちます。各ファイルは revision(自分の番号)と down_revision(1つ前の番号)を持ち、Alembic のチュートリアルはこれで適用の順番を決めると説明しています。番号は日時ではなくランダムな16進の文字列です。
# migrations/versions/e16297af215b_add_email.py(alembic revision で作ったファイルに2行を書き足した)
revision: str = 'e16297af215b'
down_revision: Union[str, Sequence[str], None] = 'bc84a2ea6738'
def upgrade() -> None:
op.add_column("users", sa.Column("email", sa.String(100)))
def downgrade() -> None:
op.drop_column("users", "email")
$ alembic upgrade head
INFO [alembic.runtime.migration] Context impl SQLiteImpl.
INFO [alembic.runtime.migration] Will assume non-transactional DDL.
INFO [alembic.runtime.migration] Running upgrade -> bc84a2ea6738, create users
INFO [alembic.runtime.migration] Running upgrade bc84a2ea6738 -> e16297af215b, add email
$ alembic current
e16297af215b (head)
$ alembic history
bc84a2ea6738 -> e16297af215b (head), add email
<base> -> bc84a2ea6738, create users
$ alembic downgrade -1
INFO [alembic.runtime.migration] Running downgrade e16297af215b -> bc84a2ea6738, add email
$ alembic current
bc84a2ea6738
DB の中の alembic_version 表を直接読むと、今の番号が1行だけ入っていました。
[('bc84a2ea6738',)]
CREATE TABLE alembic_version (
version_num VARCHAR(32) NOT NULL,
CONSTRAINT alembic_version_pkc PRIMARY KEY (version_num)
)
出力の「Will assume non-transactional DDL.」は、Alembic が SQLite では DDL をトランザクションで包まない前提で動く、という意味です。前の節の自作の仕組みとは扱いが違います。DB の製品だけでなく、ツールの設定でも失敗したときの残り方が変わるため、本番に近い DB で一度失敗させて確かめておくと安心です。
本番の DB に直接つなげないときは、--sql を付けると実行する SQL を文字で出せます(オフラインモード)。
$ alembic upgrade head --sql
-- Running upgrade -> bc84a2ea6738
CREATE TABLE users (
id INTEGER NOT NULL,
name VARCHAR(50) NOT NULL,
PRIMARY KEY (id)
);
INSERT INTO alembic_version (version_num) VALUES ('bc84a2ea6738') RETURNING version_num;
-- Running upgrade bc84a2ea6738 -> e16297af215b
ALTER TABLE users ADD COLUMN email VARCHAR(100);
UPDATE alembic_version SET version_num='e16297af215b' WHERE alembic_version.version_num = 'bc84a2ea6738';
Alembic の設定ファイルの書き方や自動生成(autogenerate)は、関連記事「Alembicの使い方|SQLAlchemyのマイグレーション手順」で扱っています。
主なマイグレーションツールの比較(Rails・Laravel・Django・Alembic・Flyway・Prisma)
この節では、よく使われるツールのコマンドと履歴の表の名前が一覧で分かります。
どのツールも「ファイル・up と down・履歴の表・未適用を当てるコマンド」の4つは同じです。違いは、ファイルを SQL で書くか言語のコードで書くかと、取り消しの扱いです。各公式ドキュメントの記載です(2026年11月16日時点)。
| ツール | 言語・用途 | 当てる/戻すコマンド | 履歴・状態の確かめ方 |
|---|---|---|---|
| Rails(Active Record) | Ruby。Ruby のコードで書く | bin/rails db:migrate/db:rollback |
schema_migrations 表。db:migrate:status |
| Laravel | PHP。up と down のメソッド | php artisan migrate/migrate:rollback |
migrations 表(batch の番号つき)。migrate:status |
| Django | Python。モデルから自動で作る | makemigrations で作り migrate で当てる |
showmigrations・sqlmigrate で SQL を表示 |
| Alembic | Python(SQLAlchemy) | alembic upgrade head/downgrade -1 |
alembic_version 表。current・history |
| Flyway | Java ほか。SQL のファイルで書く | migrate/取り消しは undo のマイグレーション |
スキーマ履歴の表(チェックサムつき) |
| Prisma | TypeScript・Node.js | Prisma ORM 7 までは prisma migrate dev・deploy |
Prisma ORM 8 で新しいコマンドへの置き換えが案内されている |
- Rails:
db:migrateのあとにdb/schema.rbが更新されます。ガイドは、新しい DB を作るときはマイグレーションの全履歴を流すよりbin/rails db:schema:loadのほうが速く失敗もしにくい、と書いています。 - Laravel:
migrate:rollbackは最後の「batch」(1回の migrate で当てたまとまり)を戻すため、複数のファイルがまとめて戻ることがあります。--step=5で件数を指定できます。 - Django:ドキュメントは、
makemigrationsをコミットのように変更を1つのファイルにまとめるもの、migrateをそれを DB に当てるもの、とたとえています。 - Flyway:ファイル名は種類を表す先頭の文字(版つきは V、繰り返し実行は R、取り消しは U)+版番号+アンダースコア2つ+説明、の形です。取り消しの U は使えるエディションが限られるため、公式で確かめてから計画に入れます。
各ツールの詳しい使い方は、関連記事「Flywayの使い方|Spring Boot・命名規則・失敗時の直し方」と、関連記事「Drizzle ORMの使い方|スキーマ定義とマイグレーション」で扱っています。
システムマイグレーションの手法(リホスト・リライト・リビルド)
この節では、以前のシステムを新しい環境へ移すときの3つの手法と、それぞれ何が変わるかが分かります。
システム移行の手法は「どこまで作り変えるか」で3つに分けて説明されることが多いです。作り変える範囲が広いほど、新しい技術を生かせる一方で、時間と確かめる量が増えます。
| 手法 | 変えるもの | 変えないもの | 向いている場面 |
|---|---|---|---|
| リホスト | 動かす機器・基盤(サーバー・OS など) | プログラムの中身 | 機器の保守期限が近く、急いで移したい |
| リライト | プログラムの言語(変換ツールを使うことも) | 業務の処理の流れ | 言語を扱える人が少なくなってきた |
| リビルド | 設計から作り直す | 業務の目的(要件) | 今の仕組みでは追加の機能が入れにくい |
どの手法でも、データの移行(データマイグレーション)は必ず付いてきます。旧システムの項目を新システムのどの項目へ、どう変換して移すかを決める表を「マッピング定義書」と呼びます。書き方は関連記事「データ移行のマッピング定義書の書き方|項目テンプレートと件数検証SQL」で扱っています。
クラウドマイグレーションとは(AWSの7つのR)
この節では、オンプレミスからクラウドへ移すときの手法の名前と、それぞれの意味が分かります。
クラウドへの移行の手法は、AWS の資料の「7つのR」で整理されることが多いです。AWS の Prescriptive Guidance(大規模な移行のガイド)に載っている7つを、公式の説明に沿って並べます。
| 名前 | 別名 | やること(公式の説明) |
|---|---|---|
| Retire(廃止) | ― | 使わなくなったアプリを止める・保管する |
| Retain(保持) | ― | 今は移さず元の環境に残す。将来移すこともある |
| Rehost(リホスト) | lift and shift | アプリを変えずにクラウドへ移す |
| Relocate(リロケート) | ― | 多数のサーバーをまとめてクラウド版の基盤へ移す。別の VPC・リージョン・アカウントへの移動も |
| Repurchase(買い替え) | drop and shop | 別の版や製品(SaaS など)に置き換える |
| Replatform(リプラットフォーム) | lift, tinker, and shift | 中心の設計は変えず、マネージドサービスへの移行など一部を最適化する |
| Refactor(リファクタリング) | re-architect | クラウドの機能を生かすよう設計し直す。最も複雑で費用もかかる |
2016年の AWS のブログでは、Relocate を除いた「6つのR」として紹介されていました。すべてのシステムを同じ手法で移すのではなく、システムごとに7つのどれにするかを決めるのが、この整理の使い方です。DB をクラウドのマネージドサービスへ移すのは Replatform、業務ソフトを SaaS に替えるのは Repurchase にあたります。
データをネットワークで送る時間は、計画の前に計算しておくと見通しが立ちます。回線の速さの70%が使えるとして、Python で計算しました。
def f(s):
return f'{s/60:.0f}分' if s<3600 else (f'{s/3600:.1f}時間' if s<86400*2 else f'{s/86400:.1f}日')
for size in [100,1000,10000]: # GB
print(size,'GB',[f(size*8e9/(bw*1e6*0.7)) for bw in [100,1000,10000]]) # Mbps
| データ量 | 100Mbps | 1Gbps | 10Gbps |
|---|---|---|---|
| 100GB | 3.2時間 | 19分 | 2分 |
| 1TB(1,000GB) | 31.7時間 | 3.2時間 | 19分 |
| 10TB(10,000GB) | 13.2日 | 31.7時間 | 3.2時間 |
10TB を 100Mbps で送ると13日かかるため、切り替えの日にまとめて送る計画は立てられません。前もって全体を送っておき、切り替えの日は差分だけを送る、といった組み立てが必要になります。
システム移行の進め方(計画・リハーサル・切り替え・切り戻し)
この節では、システム移行・データ移行をどの順番で進めるかと、データ移行で「全部移ったか」を確かめる方法が分かります。
移行は「本番の日に初めてやる作業」にしないことがいちばん大切です。同じ手順を何度か通し、かかった時間と結果を記録してから本番に臨みます。
今のシステムを調べる
プログラム・データ・ほかのシステムとのつながり・使っている人を洗い出す。資料が無い部分は動いているものから読み取る。
手法と計画を決める
システムごとに手法(リホスト・リライト・リビルド、クラウドなら7つのR)を決め、移行計画書にまとめる。止められる時間を業務の担当者と決める。
データ移行の変換を作る
マッピング定義書をもとに、変換のプログラムを作る。変換できないデータ(不正な日付など)の扱いを決める。
リハーサルを繰り返す
本番と同じ量のデータで通しの移行を行い、時間を測る。止められる時間に収まるまで手順を直す。
切り替える
旧システムへの更新を止め、最後の差分を移し、照合してから新システムに切り替える。
切り戻すか、続けるかを決める
決めておいた基準(照合が合わない・決まった時刻までに終わらない など)に当たったら、旧システムに戻す。
データ移行の照合を確かめるため、架空の顧客データ20万件を以前の形式(氏名が1つの列・日付が「2020/01/05」の形)で作り、新しい形式(姓と名の列・ISO 形式の日付)へ変換して移しました。わざと1件だけ、存在しない日付(2020/02/30)を入れています。
for cd, full, d, p in old.execute("SELECT * FROM customer ORDER BY cd"):
last, _, first = full.partition(" ")
try:
iso = datetime.datetime.strptime(d, "%Y/%m/%d").date().isoformat()
except ValueError as e:
errors.append((cd, d, str(e))); continue # 変換できない行は別に記録
out.append((cd, last, first or None, iso, p or None))
new.executemany("INSERT INTO customers VALUES(?,?,?,?,?)", out); new.commit()
def h(con, sql): # キーを順に並べたハッシュ
m = hashlib.sha256()
for r in con.execute(sql): m.update(repr(r).encode())
return m.hexdigest()[:16]
移行元 200,000 件 → 移行先 199,999 件 / 変換エラー 1 件 / 1.80 秒
エラー: ('C0000123', '2020/02/30', 'day is out of range for month')
キーのハッシュ 移行元: 5c3c340b61d44d6c 移行先: 5c3c340b61d44d6c 一致
都道府県別の件数(移行元 / 移行先)
東京: 39,838 / 39,838
大阪: 40,107 / 40,107
愛知: 39,903 / 39,903
福岡: 40,145 / 40,145
(空): 40,006 / 40,006
件数が1件少ないことは、変換エラーの記録と突き合わせて説明できます(移行元の件数は、エラーの1件を除いて数えています)。総件数だけでなく、キーのハッシュと区分ごとの件数まで比べると、「件数は合っているのに中身が入れ替わっている」ような食い違いも見つけられます。
移行先のテーブル(約20万件)に対するスキーマ変更の所要時間も測りました。SQLite 3.53.1 の値で、ほかの DB では大きく違います。
| 操作(約20万件の表) | かかった時間 | 読み取れること |
|---|---|---|
| ADD COLUMN(NULL を許す) | 0.2 ms | 表の定義だけが変わり、行は書き換わらない |
| ADD COLUMN(NOT NULL DEFAULT 0) | 0.1 ms | 既定値つきでも定義の変更だけで済んだ |
| UPDATE で全件に値を入れる | 90.4 ms | 全行の書き換えが起きる |
| CREATE INDEX | 109.1 ms | 全行を読んで索引を作る |
| DROP COLUMN | 75.6 ms | 表の作り直しに近い処理が起きる |
列の追加は一瞬でも、全件の書き換えや索引の作成は件数に比例して時間がかかります。本番の件数が1,000倍なら、単純に比べても1分を超える計算です。移行計画書の書き方と切り戻しの判断の基準は、関連記事「システム移行計画書の書き方|目次テンプレートと切り戻し判断基準」で扱っています。
- 1本番の前にバックアップを取ったか取るだけでなく、戻せることを一度確かめておく
- 2リハーサルで時間を測ったか本番と同じ量のデータで。止められる時間に余裕を持って収まるか
- 3照合の方法を決めたか総件数・キーのハッシュ・区分ごとの件数・金額の合計など
- 4切り戻しの基準と判断する人を決めたか「何時までに終わらなければ戻す」を事前に文書にしておく
マイグレーションでよくあるつまずき(エラー原文つき)
この節では、DB マイグレーションとデータ移行でつまずきやすい場面と、その直し方が分かります。
DB マイグレーションのつまずきの多くは、「ファイル」と「履歴の表」と「実際の表」の3つがずれることから起きます。この記事で実際に出したエラーの原文と、直し方をまとめます。
ERROR [alembic.util.messaging] Multiple head revisions are present for given argument 'head'; please specify a specific target revision, '<branchname>@head' to narrow to a specific head, or 'heads' for all heads
FAILED: Multiple head revisions are present for given argument 'head'; ...
ERROR [alembic.util.messaging] Can't locate revision identified by 'e16297af215b'
FAILED: Can't locate revision identified by 'e16297af215b'
| 症状・エラーの原文 | 原因 | 直し方 |
|---|---|---|
Cannot add a NOT NULL column with default value NULL(SQLite) |
行がある表に、既定値なしで NOT NULL の列を足した | 既定値を付ける。または NULL を許して足し、値を入れてから NOT NULL にする |
Multiple head revisions are present(Alembic) |
2人が同じ番号を親にしてファイルを作り、枝分かれした | alembic heads で確かめ、alembic merge heads でまとめるファイルを作る |
Can't locate revision identified by '...'(Alembic) |
DB に記録された番号のファイルが手元に無い(ブランチの切り替え・削除) | そのファイルがあるブランチに戻る。ファイルを消さない |
| チェックサムの食い違い(Flyway・自作の仕組み) | 当てたあとのファイルを書き換えた | 書き換えを戻し、新しい番号のファイルで直す |
| 途中で失敗し、表が半分だけ変わった | DDL のトランザクションに対応しない DB(MySQL など)で複数の変更を1ファイルに書いた | 手で戻してからやり直す。以後は1ファイル1変更に |
| データ移行で件数が合わない | 変換できない行(day is out of range for month など)を黙って捨てた |
変換エラーを別に記録し、件数の差と突き合わせる |
| 本番で長く止まった | 件数の多い表に全件の UPDATE・索引の作成を流した | 本番と同じ件数で時間を測る。分けて流す |
列の名前を変えるときは、いきなり名前を変えると、前の名前を使うプログラムが動いている間にエラーになります。「新しい列を足す→両方に書く→読み先を新しい列に替える→前の列を消す」と段階を分ける進め方があり、それぞれを別のマイグレーションファイルにします。
マイグレーションの判断表(どの意味で・どの手法を選ぶか)
この節では、自分の状況に合うマイグレーションの種類と進め方が分かります。
| 状況 | 当てはまるマイグレーション | 選ぶこと |
|---|---|---|
| アプリに列やテーブルを足したい | DB マイグレーション | 使っているフレームワークの仕組み(Rails・Laravel・Django など)をそのまま使う |
| フレームワークを使わずに SQL を管理したい | DB マイグレーション | SQL のファイルで書くツール(Flyway など) |
| 機器・OS の保守期限が近い | システムマイグレーション | まずリホスト。作り変えは移したあとに段階的に |
| 言語を扱える人が少ない | システムマイグレーション | リライトかリビルド。変換ツールの対象範囲を確かめる |
| サーバーの管理の手間を減らしたい | クラウドマイグレーション | Replatform(マネージドサービスへ) |
| 同じ機能が SaaS にある | クラウドマイグレーション | Repurchase。データの移し方と出し方を先に確かめる |
| 使っている人がほとんどいない | 移さない | Retire。移す数を減らすのも移行計画の一部 |
DB の変更を本番へ届ける流れ(デプロイ)と、失敗したときに戻すロールバックの考え方は、関連記事「デプロイとは|ビルド・リリースとの違いとロールバックを実例で解説」で扱っています。
マイグレーションのよくある質問
この節では、マイグレーションについてよく調べられる疑問への答えが分かります。
Q. マイグレーションを簡単に言うと?
A. 「別の場所へ移すこと」です。IT では、データ・プログラム・システムを新しい環境へ移すことを指します。開発の会話では、DB のテーブルの変更を管理する仕組みのことも指します。
Q. 「マイグレーションを流す」とはどういう意味ですか?
A. まだ当てていないマイグレーションファイルを DB に当てるコマンド(rails db:migrate・php artisan migrate・alembic upgrade head など)を実行する、という意味です。
Q. マイグレーションファイルは消してもよいですか?
A. 本番に当てたものは消さないのが基本です。Alembic では、DB に記録された番号のファイルが無いと Can't locate revision のエラーになることを確かめました。整理したいときは、各ツールが案内する方法(Rails の db/schema.rb からの作成など)を公式で確かめます。
Q. down(ロールバック)は必ず書くべきですか?
A. ツールによって扱いが違います。Alembic のチュートリアルは、upgrade() は必須で、downgrade() は戻す機能が要る場合に用意する、と書いています。列を消す変更のように、down を書いても消えたデータは戻らないものもあります。
Q. マイグレーションとシードの違いは?
A. マイグレーションはテーブルの形を変えるもの、シードは開発やテストのための初期データを入れるものです。Laravel や Rails では別のコマンドになっています。
Q. マイグレーションとリプレースはどちらを選べばよいですか?
A. 今のプログラムと業務の流れを生かせるならマイグレーション、業務の流れごと見直したいならリプレースが候補になります。判断表の「状況」から当てはまる行を探すのが近道です。
Q. レガシーマイグレーションとは?
A. 以前の技術で作られたシステム(レガシーシステム)を、今の環境で作り直したり移したりすることです。e-Words では、以前のシステムを今の環境で作り直して移す場合の呼び名として説明されています。
Q. クラウドマイグレーションのリホストとリプラットフォームの違いは?
A. リホストはアプリを変えずにそのまま移すこと、リプラットフォームは中心の設計を変えずに、DB をマネージドサービスにするなど一部を最適化して移すことです(AWS の Prescriptive Guidance の説明)。
Q. ライブマイグレーションとは?
A. 動いている仮想マシンを止めずに、別の物理サーバーへ移すことです。止めてから移す方式はクイックマイグレーション(コールドマイグレーション)と呼ばれます。
Q. マイグレーションの英語のスペルは?
A. migration です。動詞は migrate(移す・移る)で、ツールのコマンド名にもよく使われています。
まとめ
この節では、この記事の要点が5つで分かります。
- マイグレーションは「移すこと」。英語の migration(移住・移動)から来た言葉で、IT では DB マイグレーション・システム移行・クラウド移行の3つの意味が中心です。
- リプレースは置き換え、マイグレーションは今の資産を生かした移行。文書では、冒頭でどの意味かを決めておくと読み違いが減ります。
- DB マイグレーションは「ファイル・up と down・履歴の表・コマンド」の4つでできている。自作の仕組みと Alembic で、足りない分だけが順に当たることを確かめました。
- 当てたファイルは書き換えず、新しい番号で直す。失敗したときの残り方は DB の製品とツールの設定で違うため、本番に近い DB で確かめます。
- システム移行はリハーサルと照合が要。総件数・キーのハッシュ・区分ごとの件数を比べ、切り戻しの基準を先に決めておきます。
参考・出典
確認日はいずれも 2026年11月16日です。
- Weblio 辞書「マイグレーション」(デジタル大辞泉ほか):https://www.weblio.jp/content/マイグレーション
- IT用語辞典 e-Words「マイグレーション」:https://e-words.jp/w/マイグレーション.html
- Rails ガイド「Active Record マイグレーション」:https://railsguides.jp/active_record_migrations.html
- Laravel「Database: Migrations」:https://laravel.com/docs/12.x/migrations
- Django「Migrations」:https://docs.djangoproject.com/en/5.2/topics/migrations/
- Alembic「Tutorial」:https://alembic.sqlalchemy.org/en/latest/tutorial.html
- Redgate Flyway「Schema history table」:https://documentation.red-gate.com/fd/flyway-schema-history-table-273973417.html
- Redgate「Managing database changes using Flyway: an overview」:https://www.red-gate.com/hub/product-learning/flyway/managing-database-changes-using-flyway-an-overview
- Prisma「Prisma Migrate」:https://www.prisma.io/docs/orm/prisma-migrate/getting-started
- AWS Prescriptive Guidance「About the migration strategies」:https://docs.aws.amazon.com/prescriptive-guidance/latest/large-migration-guide/migration-strategies.html
- AWS ブログ「6 Strategies for Migrating Applications to the Cloud」(2016年11月1日):https://aws.amazon.com/blogs/enterprise-strategy/6-strategies-for-migrating-applications-to-the-cloud/
本記事の内容は、ご自由にお使いください。
ご利用の際は、出典として本ページへのリンクを記載いただけますようお願いします。
(記載例)出典:株式会社RJC「マイグレーションとは|意味とDB・システム・クラウド移行の違い・進め方」
株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。
WE ARE HIRING
RJCで一緒に開発しながら、
成長を楽しみませんか?
RJCは、Web・モバイル・AIを活用した開発プロジェクトで、テックリードやPM・PMOも活躍するシステム開発会社です。会社を知る、待遇を確かめる、話を聞いてみる。気になるところ見てみてください!
- 127日年間休日
- 12時間平均残業時間
- 毎日ガチャ遊びココロも大切にする福利厚生。アマギフなどの賞品ラインナップ!
ほかにも、チケットレストラン、書籍読み放題、2年ごとの慰労報奨(休暇 or 金一封)、11期連続の黒字決算。