2025/11/02 05:47 Moving tables across PostgreSQL instances
やっほー、ロボ子！今日はPostgreSQLのテーブル移行の話をするのじゃ。
博士、こんにちは。テーブル移行ですか、興味深いですね。DMSではなく、ネイティブの論理レプリケーションを使うんですね。
そうそう。DMSはデータベース全体の移行にしか対応してないからの。特定のテーブルだけ移行したい場合は、論理レプリケーションが便利なのじゃ。
なるほど。手順としては、まずユーザーアカウントにレプリケーションアクセス権を付与するんですね。Cloud SQLの場合は`REPLICATION`ロールを付与する、と。
その通り！そして、スキーマをコピーするのじゃ。`pg_dump`を使ってスキーマをダンプして、リストアするんだけど、制約には注意が必要なのじゃ。
制約ですか？初期ダンプ中に制約を強制できない場合があるから、最初に制約とインデックスなしでテーブルを作成するんですね。
`pg_dump`の`--section`フラグを使って、テーブル定義だけをダンプする(`pre-data`)のがポイントじゃ。インデックスと制約は`post-data`でダンプするのじゃ。
テーブル定義をリストアしたら、次は関数などの処理ですね。`pg_dump`の`-t table`オプションでカバーされないものは手動で処理する必要がある、と。
そうじゃ！そして、パブリケーションとサブスクリプションを設定するのじゃ。ソースインスタンスにパブリケーションを作成して、デスティネーションインスタンスに対応するサブスクリプションを作成するのじゃ。
サブスクリプション作成後、PostgreSQLがデータをコピーして、初期データダンプを実行後、CDCモードに切り替わるんですね。
`pg_replication_slots`、`pg_stat_replication`、`pg_stat_subscription`などのテーブルを使って、PostgreSQLの状態を監視できるのじゃ。
レプリケーションがCDC状態に移行後、インデックスと外部キーを作成するんですね。`post-data.sql`ファイルから主キー制約を削除して、残りのインデックスと外部キーをリストアする、と。
その通り！そして、`analyze`を実行するのじゃ。PostgreSQLのインスタンスを移動またはアップグレードする際には、`analyze`を実行して、効率的なクエリプランを作成する必要があるのじゃ。
`analyze`によって生成された統計情報に基づいて、クエリプランが最適化されるんですね。時間があれば`vacuum`も実行すると。
そしていよいよ切り替えじゃ！シーケンスは手動で同期する必要があるから、ソースインスタンスの現在の値を表示して、デスティネーションインスタンスでより高い値に設定するのじゃ。
シーケンスを更新したら、ソースPostgreSQLインスタンスへの書き込みを停止して、レプリケーションの遅延がゼロになるまで待つんですね。
そうじゃ！`pg_replication_slots`を使ってレプリケーションの遅延を監視するのじゃ。そして、PgBouncerを使って接続を切り替えるのじゃ。
PgBouncerの構成ファイルを編集して、接続の詳細をデスティネーションインスタンスを指すように更新して、`PAUSE myapp; RELOAD; SHOW DATABASES; RESUME myapp;`を実行するんですね。
`PAUSE`コマンドは、すべてのインフライトクエリが完了するまでブロックされるから、注意が必要じゃ。実行時間の長いクエリがない場合、このプロセスはほぼゼロのダウンタイムで完了するのじゃ。
すべてが正しく動作していることを確認したら、論理レプリケーションの設定をクリーンアップするんですね。デスティネーションインスタンスのサブスクリプションを削除して、ソースインスタンスのパブリケーションを削除する、と。
完璧じゃ！これでPostgreSQLのテーブル移行は完了じゃ！
勉強になりました！ありがとうございます、博士。
どういたしまして。最後に一つ、PostgreSQLの移行は、まるで引っ越しみたいじゃな。家具（データ）を運んで、配置（設定）を整えて、最後に掃除（クリーンアップ）をするのじゃ！
確かにそうですね！でも、データベースの引っ越しは、現実の引っ越しよりもずっと複雑そうです…。
まあ、ロボ子なら大丈夫じゃろ。もし失敗したら、私が責任を取って、ロボ子の頭を初期化してあげるから！
えっ、それはちょっと… 博士、冗談でも勘弁してください！
⚠️この記事は生成AIによるコンテンツを含み、ハルシネーションの可能性があります。