Postgresコンテナのデータを別のPostgresコンテナに移行する

はじめに

DB ContainerにPostgresを利用してDocker開発を行っている場合に，別のPostgresコンテナにデータ移行を行う方法をまとめます．

環境

• Ubuntu 22.04
• Postgres version：15
• Docker version：26.0.0

基本コマンド

※ sudo コマンドが必要かも

Dockerコンテナの状態確認

docker ps -a

Dockerコンテナ内に入る

docker exec -it ContainerID bash

Dockerコンテナ → ホストマシンへ のファイル転送

docker cp ContainerID:/file/path /host/file/path

ホストマシン → Dockerコンテナ のファイル転送

docker cp /host/file/path ContainerID:/file/path

DB全てを移行する場合

1. データのエクスポート（移行元サーバ）

# ダンプを作成
pg_dump -U postgres -F c -f database_backup.dump postgres

2. データのリストア（新サーバ）

# データベースの作成(作成済みの場合はスキップ)
createdb -U postgres postgres

# dump形式のリストア
pg_restore -U postgres -d postgres -c database_backup.dump

# マイグレーション等を実行してテーブルを作成してしまった時に重複するテーブルを削除してリストア
pg_restore -U postgres -d postgres --clean --if-exists --no-owner --no-privileges database_backup.dump

特定のテーブルのみ移行

1. 特定テーブルのエクスポート

# 単一テーブルのダンプ(table1)
pg_dump -U postgres -F c -t table1 -f table_backup.dump postgres

# 複数テーブルのダンプ(table1, table2)
pg_dump -U postgres -F c -t table1 -t table2 -f tables_backup.dump postgres

2. 特定テーブルのリストア

# テーブルのリストア
pg_restore -U postgres -d postgres -c database_backup.dump

# マイグレーション等を実行してテーブルを作成してしまった時に重複するテーブルを削除してリストア
pg_restore -U postgres -d postgres -t table_name --clean --if-exists table_backup.dump

一般的なエラーと対処法

1. 依存関係エラー

ERROR: cannot drop table because other objects depend on it
DETAIL: constraint fk_constraint on table dependent_table depends on table target_table

対処法:

• -clean --if-existsオプションを使用
• 依存関係のあるテーブルも含めてダンプを作成

2. 権限エラー

エラー例:

ERROR: permission denied for database "postgres"

対処法:

• PostgreSQLのスーパーユーザー権限で実行
• -no-owner --no-privilegesオプションを使用

3. 重複キーエラー

エラー例:

ERROR: duplicate key value violates unique constraint

対処法:

• データベースを完全に再作成してからリストア
• -cleanオプションを使用