このページでは、移行ジョブの構成時に Database Migration Service が自動的に作成する新しい Cloud SQL for PostgreSQL インスタンスにデータベースを移行する方法について説明します。移行の要件が異なる場合は、別の移行フローを検討してください。詳細については、 ガイド: 既存の Cloud SQL インスタンスに移行するをご覧ください。
大まかに、移行は次の手順で行われます。
- Database Migration Service が新しいデータベースにデータを移動できるように、移行元データベースを構成します。
- ソース接続プロファイルと移行ジョブを作成します。
- 接続構成によっては、ファイアウォール設定の調整が必要になる場合があります。
- 移行ジョブを開始してモニタリングします。
- 移行ジョブをプロモートし、新しいデータベースを使用するようにアプリケーションを移行します。
費用
このドキュメントでは、課金対象である次のGoogle Cloudコンポーネントを使用します。
- Cloud SQL( Cloud SQL の料金をご覧ください)。
- 顧客管理の暗号鍵(CMEK)の保存に使用する場合: Cloud Storage( Cloud Storage の料金をご覧ください)。
料金計算ツールを使うと、予想使用量に基づいて費用の見積もりを生成できます。
始める前に
- この移行パスがシナリオを完全にサポートできるかどうかを確認します。次のページをご覧ください。
- シナリオの概要ページの サポートされている移行元と移行先に、サポートされているすべての移行元と移行先のバージョンが一覧表示されます。
- 既知の制限事項では、サポートされているデータ型、データベース サイズ、その他の制限事項について説明しています。
-
移行元のデータベースに応じて、さまざまなネットワーク接続方法を使用できます。移行手順を開始する前に、ネットワーク接続を検討して計画します。詳細については、 ネットワーキングの概要をご覧ください。
新しい宛先インスタンスへの移行では、Private Service Connect インターフェース接続はサポートされていません。Private Service Connect インターフェース接続を使用する場合は、Cloud SQL で移行先インスタンスを直接事前に作成することを検討してください。 ガイド: 既存の Cloud SQL インスタンスに移行するをご覧ください。
- 宛先データベースを作成するリージョンを検討します。Database Migration Service は完全にリージョン対応のプロダクトです。つまり、移行に関連するすべてのエンティティ(移行元と移行先の接続プロファイル、移行ジョブ、移行先データベース、コンバージョン ワークスペース)を 1 つのリージョンに保存する必要があります。
- Google Cloud コンソールのプロジェクト セレクタ ページで、 Google Cloud プロジェクトを選択または 作成します。
- Database Migration Service API と Cloud SQL Admin API を有効にします。
必要なロール
Database Migration Service を使用して同種の PostgreSQL 移行を実行するために必要な権限を取得するには、プロジェクトに対する必要な IAM ロールを付与するよう管理者に依頼してください。
-
データベース移行管理者(
roles/datamigration.admin) -
Cloud SQL 編集者(
roles/cloudsql.editor) -
Cloud SQL Studio ユーザー(
roles/cloudsql.studioUser)
ロールの付与の詳細については、Identity and Access Management のドキュメントの アクセスを管理するをご覧ください。
これらの事前定義ロールには、Database Migration Service を使用して同種の PostgreSQL 移行を実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
Database Migration Service を使用して同種の PostgreSQL 移行を実行するには、次の権限が必要です。
datamigration.*cloudsql.instances.createcloudsql.instances.getcloudsql.instances.listcloudsql.instances.updatecloudsql.instances.deletecloudsql.operations.getcloudsql.users.listcloudsql.users.getcloudsql.users.createcloudsql.users.updatecloudsql.users.delete
カスタムロールや他の 事前定義ロールを使用して、これらの権限を取得することもできます。
ソース データベースを準備する
移行するソースデータを準備する手順は次のとおりです。
-
移行元ネットワークの接続方法を選択して構成する。
パブリック IP 許可リスト接続の場合: 後で、Database Migration Service が移行先インスタンスを作成した後、Cloud SQL のパブリック IP アドレスをファイアウォールの許可リストに追加する必要がある場合があります。このような構成変更をスケジュール設定する最適な方法については、ネットワーク管理者にお問い合わせください。
- ソース データベース インスタンスを構成します。大まかな手順は次のとおりです。
- ソース データベースと移行対象のすべてのデータベースに
pglogicalPostgreSQL 拡張機能(バージョン 2.2.1 以降)をインストールします。 - PostgreSQL パラメータを構成します。
wal_level = logicalを設定し、max_replication_slots、max_wal_senders、max_worker_processesに適切な値を設定します。 - 移行ユーザーにレプリケーション権限を付与し、移行先の Cloud SQL インスタンスからの接続を許可するように
pg_hba.confを構成します。
詳細な手順については、 移行元データベースを構成するをご覧ください。
- ソース データベースと移行対象のすべてのデータベースに
- ソース接続プロファイルを作成する。
移行ジョブを作成して実行する
移行を構成して実行する手順は次のとおりです。
- 省略可: 宛先インスタンスに独自の暗号鍵を管理する場合は、 顧客管理の暗号鍵(CMEK)を準備します。
-
移行ジョブを作成して実行します。
Database Migration Service のオブザーバビリティ機能を使用すると、移行の進行状況と移行先インスタンスの健全性をモニタリングできます。 移行ジョブの指標をご覧ください。
移行を完了する
アプリケーションを新しい Cloud SQL for PostgreSQL インスタンスに切り替える場合は、次の手順で移行を完了します。
- 省略可: カスケード リードレプリカを設定する。カスケード リードレプリカを使用する場合は、移行ジョブが CDC フェーズに入ったときに構成できます。
- ソース データベースに対するすべての書き込みオペレーションを停止します。読み取り専用モードに切り替えて、運用機能を維持できます。
- 移行ジョブをプロモートする。
- 省略可: 移行データの完全性を検証します。
次のステップ
Cloud SQL for PostgreSQL の Google Cloud 機能の詳細を確認する。 Cloud SQL for PostgreSQL の機能をご覧ください。