クイック スタート移行を使用して AlloyDB for PostgreSQL に移行する

コンソール

1. Google Cloud コンソールで、[スタートガイド] ページに移動します。

   [スタートガイド] に移動

2. [移行元エンジン] メニューで、[PostgreSQL] を選択します。
3. [移行先エンジン] メニューで、[AlloyDB for PostgreSQL] を選択します。

   [クイック スタート PostgreSQL 移行の概要] セクションが表示されます。

4. クイック スタート PostgreSQL 移行の紹介セクションで、[移行を開始] をクリックします。

   [AlloyDB for PostgreSQL への移行] ページが開きます。

5. [移行を構成する] セクションで、次の操作を行います。
   1. [移行先リージョン] メニューから、移行先 AlloyDB for PostgreSQL クラスタのリージョンを選択します。
   2. [移行接頭辞] ボックスに、クイック スタート移行用に作成されたすべての移行エンティティ（接続プロファイル、プライベート接続構成、ネットワーク アタッチメントとそのサブネット、移行ジョブ）の名前に追加されるわかりやすい文字列を入力します。
   3. [構成タイプ] メニューから、次のいずれかを選択します。
      1. 既存の接続構成: Private Service Connect インターフェース メソッドを使用するネットワーク アタッチメントとプライベート接続構成がすでにある場合は、このオプションを選択します。このオプションは、以前にクイック スタート移行を使用し、同じネットワーキング リソースを再利用する場合に最適です。
      2. 新しい接続構成: このオプションを選択すると、移行元データベースの VPC ネットワークに新しいネットワーク アタッチメントとネットワーク アタッチメント サブネットが作成されます。プライベート接続構成は、宛先クラスタと同じプロジェクトに作成されます。
   [続行] をクリックします。
6. [ソースを接続] セクションで、次の操作を行います。
   1. ソース データベースのホスト名またはプライベート IP アドレスを入力します。ソース データベースのアドレスは、ソース VPC ネットワークから到達可能である必要があります。
   2. ホストへのアクセスに使用するポートを入力します。デフォルトの PostgreSQL ポートは 5432 です。
   3. 移行元データベースの移行専用アカウントのユーザー名とパスワードを入力します。
   4. [暗号化タイプ] メニューで、次のいずれかを選択します。
      • なし: 移行元データベースで SSL/TLS 暗号化接続が必要ない場合。
      • 必須: 移行元データベースで SSL/TLS 暗号化接続が必要な場合。このオプションでは、証明書の検証は必要ありません。
   5. [移行するデータベース] メニューで、[カスタマイズ] をクリックします。サイドパネルを使用して、AlloyDB for PostgreSQL に移行するデータベースのみを選択します。
   [続行] をクリックします。
7. [転送先を構成] セクションで、新しい転送先クラスタを作成するか、既存のクラスタを選択できます。

   新しいクラスタ

   新しい移行先クラスタを作成する場合は、次の操作を行います。

   1. [移行先インスタンス タイプ] メニューから、[新しいクラスタ] を選択します。

      Database Migration Service は、新しいクラスタにデフォルトの AlloyDB for PostgreSQL 構成を使用します。[カスタマイズ] をクリックして、マシンタイプ、ゾーンの可用性、データ保護設定などのクラスタ機能を調整します。クラスタ構成の詳細については、AlloyDB for PostgreSQL ドキュメントの クラスタとそのプライマリ インスタンスを作成するをご覧ください。

   2. [パスワード] フィールドに、デフォルトの postgresql 管理ユーザーのパスワードを入力します。Database Migration Service は、このユーザーとして接続してデータを移行します。

   既存のクラスタ

   既存のクラスタにデータベースを移行できます。宛先クラスタで Private Service Connect が有効になっており、AlloyDB コネクタで mTLS が適用されていないことを確認します。次の操作を行います。

   1. [移行先インスタンス タイプ] メニューから、[既存のクラスタ] を選択します。
   2. [既存のクラスタ ID] メニューから、クラスタ識別子を選択します。
8. [移行を開始] をクリックします。

   Database Migration Service が移行ジョブを作成し、移行プロセスを開始します。AlloyDB for PostgreSQL では、移行の進行状況と移行先クラスタの健全性をモニタリングできます。詳細については、AlloyDB for PostgreSQL のドキュメントの インスタンスの詳細を表示するをご覧ください。

gcloud

gcloud CLI を使用してクイック スタートの移行を作成して実行するには、次の操作を行います。

1. ネットワーク アタッチメントを構成します。
   新しいネットワーク アタッチメントを作成するか、既存のネットワーク アタッチメントを再利用するかを決定します。ソース データベースのプライベート IP に到達できるネットワークにネットワーク アタッチメントが必要です。

   • 新しいネットワーク アタッチメントを作成する場合は、次のコマンドを実行します（クリックして詳細を表示）。

     gcloud compute network-attachments create

     後述のコマンドデータを使用する前に、次のように置き換えます。

     • NETWORK_ATTACHMENT は、作成するネットワーク アタッチメントの名前に置き換えます。
     • REGION: ネットワーク アタッチメントのリージョン。
     • DEST_PROJECT_ID は、宛先プロジェクトのプロジェクト ID に置き換えます。
     • SOURCE_PROJECT_ID: ソース ネットワークが存在するプロジェクトの ID。

     次のコマンドを実行します。

     Linux、macOS、Cloud Shell

     gcloud compute network-attachments create NETWORK_ATTACHMENT \
       --region=REGION \
       --connection-preference=ACCEPT_MANUAL \
       --producer-accept-list=DEST_PROJECT_ID \
       --subnets=default \
       --project=SOURCE_PROJECT_ID

     Windows（PowerShell）

     gcloud compute network-attachments create NETWORK_ATTACHMENT `
       --region=REGION `
       --connection-preference=ACCEPT_MANUAL `
       --producer-accept-list=DEST_PROJECT_ID `
       --subnets=default `
       --project=SOURCE_PROJECT_ID

     Windows（cmd.exe）

     gcloud compute network-attachments create NETWORK_ATTACHMENT ^
       --region=REGION ^
       --connection-preference=ACCEPT_MANUAL ^
       --producer-accept-list=DEST_PROJECT_ID ^
       --subnets=default ^
       --project=SOURCE_PROJECT_ID

2. Database Migration Service テナント プロジェクトがネットワーク アタッチメントにアクセスできるようにします。
   ネットワーク アタッチメントで、Database Migration Service テナント プロジェクトからの接続を許可する必要があります。次の手順を行います。

   1. プライベート接続の作成をドライランして、Database Migration Service テナント プロジェクト ID を取得します（クリックして展開）。

      gcloud database-migration private-connections create --validate-only

      後述のコマンドデータを使用する前に、次のように置き換えます。

      • PRIVATE_CONN は、プライベート接続リソースの名前に置き換えます。
      • REGION: プライベート接続のリージョン。
      • NETWORK_ATTACHMENT_URI は、ネットワーク アタッチメントの URI に置き換えます。

      次のコマンドを実行します。

      Linux、macOS、Cloud Shell

      gcloud database-migration private-connections create PRIVATE_CONN \
        --region=REGION \
        --network-attachment=NETWORK_ATTACHMENT_URI \
        --display-name=PRIVATE_CONN \
        --format="value(metadata.metadata.tenant_project_id)" \
        --validate-only

      Windows（PowerShell）

      gcloud database-migration private-connections create PRIVATE_CONN `
        --region=REGION `
        --network-attachment=NETWORK_ATTACHMENT_URI `
        --display-name=PRIVATE_CONN `
        --format="value(metadata.metadata.tenant_project_id)" `
        --validate-only

      Windows（cmd.exe）

      gcloud database-migration private-connections create PRIVATE_CONN ^
        --region=REGION ^
        --network-attachment=NETWORK_ATTACHMENT_URI ^
        --display-name=PRIVATE_CONN ^
        --format="value(metadata.metadata.tenant_project_id)" ^
        --validate-only

      返されたテナント プロジェクト ID を保存して、後続のコマンドで使用します。

   2. Database Migration Service のテナント プロジェクトと移行先プロジェクトがネットワーク アタッチメントに接続できるようにします（クリックして展開）。

      gcloud compute network-attachments update

      後述のコマンドデータを使用する前に、次のように置き換えます。

      • NETWORK_ATTACHMENT は、ネットワーク アタッチメントの名前に置き換えます。
      • REGION: リージョン
      • DEST_PROJECT_ID は、宛先プロジェクトのプロジェクト ID に置き換えます。
      • DMS_TENANT_ID は、取得した Database Migration Service テナント プロジェクト ID に置き換えます。
      • SOURCE_PROJECT_ID: ソース ネットワークが存在するプロジェクトの ID。

      次のコマンドを実行します。

      Linux、macOS、Cloud Shell

      gcloud compute network-attachments update NETWORK_ATTACHMENT \
        --region=REGION \
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID \
        --project=SOURCE_PROJECT_ID

      Windows（PowerShell）

      gcloud compute network-attachments update NETWORK_ATTACHMENT `
        --region=REGION `
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID `
        --project=SOURCE_PROJECT_ID

      Windows（cmd.exe）

      gcloud compute network-attachments update NETWORK_ATTACHMENT ^
        --region=REGION ^
        --producer-accept-list=DEST_PROJECT_ID,DMS_TENANT_ID ^
        --project=SOURCE_PROJECT_ID

3. プライベート接続を作成します。
   Database Migration Service が移行元ネットワークに接続できるように、プライベート接続リソースを作成します（クリックして展開）。

   gcloud database-migration private-connections create

   後述のコマンドデータを使用する前に、次のように置き換えます。

   • PRIVATE_CONN は、プライベート接続リソースの名前に置き換えます。
   • REGION: プライベート接続のリージョン。
   • NETWORK_ATTACHMENT_URI は、ネットワーク アタッチメントの URI に置き換えます。

   次のコマンドを実行します。

   Linux、macOS、Cloud Shell

   gcloud database-migration private-connections create PRIVATE_CONN \
     --region=REGION \
     --network-attachment=NETWORK_ATTACHMENT_URI \
     --display-name=PRIVATE_CONN

   Windows（PowerShell）

   gcloud database-migration private-connections create PRIVATE_CONN `
     --region=REGION `
     --network-attachment=NETWORK_ATTACHMENT_URI `
     --display-name=PRIVATE_CONN

   Windows（cmd.exe）

   gcloud database-migration private-connections create PRIVATE_CONN ^
     --region=REGION ^
     --network-attachment=NETWORK_ATTACHMENT_URI ^
     --display-name=PRIVATE_CONN

4. ソース接続プロファイルを作成します。
   次のコマンドを実行します（クリックして展開）。

   gcloud database-migration connection-profiles create postgresql

   このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

   後述のコマンドデータを使用する前に、次のように置き換えます。

   • SOURCE_CONN_ID は、移行元接続プロファイルの ID に置き換えます。
   • REGION は、接続プロファイルを保存するリージョンに置き換えます。
   • SOURCE_PRIVATE_IP は、ソース データベースのプライベート IP アドレスに置き換えます。
   • SOURCE_PORT: ソース データベースのポート（デフォルトは 5432）。
   • SOURCE_USER は、ソース データベースの移行ユーザーのユーザー名に置き換えます。
   • SOURCE_PASSWORD は、移行元データベースの移行ユーザーのパスワードに置き換えます。
   • PRIVATE_CONN は、プライベート接続リソースの名前に置き換えます。

   次のコマンドを実行します。

   Linux、macOS、Cloud Shell

   gcloud database-migration connection-profiles create postgresql \
     SOURCE_CONN_ID \
     --region=REGION \
     --role=SOURCE \
     --host=SOURCE_PRIVATE_IP \
     --port=SOURCE_PORT \
     --username=SOURCE_USER \
     --password=SOURCE_PASSWORD \
     --private-connection=PRIVATE_CONN \
     --no-async

   Windows（PowerShell）

   gcloud database-migration connection-profiles create postgresql `
     SOURCE_CONN_ID `
     --region=REGION `
     --role=SOURCE `
     --host=SOURCE_PRIVATE_IP `
     --port=SOURCE_PORT `
     --username=SOURCE_USER `
     --password=SOURCE_PASSWORD `
     --private-connection=PRIVATE_CONN `
     --no-async

   Windows（cmd.exe）

   gcloud database-migration connection-profiles create postgresql ^
     SOURCE_CONN_ID ^
     --region=REGION ^
     --role=SOURCE ^
     --host=SOURCE_PRIVATE_IP ^
     --port=SOURCE_PORT ^
     --username=SOURCE_USER ^
     --password=SOURCE_PASSWORD ^
     --private-connection=PRIVATE_CONN ^
     --no-async

5. 移行先接続プロファイルを作成します。
   新しい AlloyDB for PostgreSQL クラスタに移行するか、既存の AlloyDB for PostgreSQL クラスタに移行するかに応じて、タブを選択します。

   新しいクラスタ

   クイック スタート移行に新しい移行先クラスタを使用するには、まず AlloyDB for PostgreSQL Google Cloud CLI を使用してクラスタとそのプライマリ インスタンスを作成し、次に移行先接続プロファイルを作成します。手順は次のとおりです。

   1. AlloyDB for PostgreSQL Google Cloud CLI を使用して、 クラスタとそのプライマリ インスタンスを作成します。 --enable-private-service-connect フラグを使用して、Private Service Connect の宛先クラスタを有効にしてください。クイック スタート移行は、Private Service Connect が有効になっている宛先のみをサポートします。
   2. 新しいクラスタの移行先接続プロファイルを作成します。コマンドの詳細については、次のセクションを開いてください。

      gcloud database-migration connection-profiles create postgresql

      このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

      後述のコマンドデータを使用する前に、次のように置き換えます。

      • DEST_CONN_ID は、宛先接続プロファイルの識別子に置き換えます。
      • REGION は、接続プロファイルを保存するリージョンに置き換えます。このリージョンは、宛先クラスタのリージョンと同じにする必要があります。
      • DEST_CLUSTER: 移行先の AlloyDB for PostgreSQL クラスタの ID または完全なリソースパス。
      • DEST_USER は、移行先データベースの移行ユーザーのユーザー名に置き換えます。
      • DEST_PASSWORD は、宛先データベースの移行ユーザーのパスワードに置き換えます。

      次のコマンドを実行します。

      Linux、macOS、Cloud Shell

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
        --region=REGION \
        --alloydb-cluster=DEST_CLUSTER \
        --username=DEST_USER \
        --password=DEST_PASSWORD \
        --role=DESTINATION \
        --no-async

      Windows（PowerShell）

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
        --region=REGION `
        --alloydb-cluster=DEST_CLUSTER `
        --username=DEST_USER `
        --password=DEST_PASSWORD `
        --role=DESTINATION `
        --no-async

      Windows（cmd.exe）

      gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
        --region=REGION ^
        --alloydb-cluster=DEST_CLUSTER ^
        --username=DEST_USER ^
        --password=DEST_PASSWORD ^
        --role=DESTINATION ^
        --no-async

      次のようなレスポンスが返されます。

      Waiting for connection profile [CONNECTION_PROFILE_ID]
      to be created with [OPERATION_ID]
      
      Waiting for operation [OPERATION_ID] to complete...done.
      
      Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
      

   既存のクラスタ

   既存の宛先クラスタに移行するには、事前に作成したクラスタを指す接続プロファイルを作成します。次のコマンドを実行します（クリックして展開）。

   gcloud database-migration connection-profiles create postgresql

   このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

   後述のコマンドデータを使用する前に、次のように置き換えます。

   • DEST_CONN_ID は、宛先接続プロファイルの識別子に置き換えます。
   • REGION は、接続プロファイルを保存するリージョンに置き換えます。このリージョンは、宛先クラスタのリージョンと同じにする必要があります。
   • DEST_CLUSTER: 移行先の AlloyDB for PostgreSQL クラスタの ID または完全なリソースパス。
   • DEST_USER は、移行先データベースの移行ユーザーのユーザー名に置き換えます。
   • DEST_PASSWORD は、宛先データベースの移行ユーザーのパスワードに置き換えます。

   次のコマンドを実行します。

   Linux、macOS、Cloud Shell

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID \
     --region=REGION \
     --alloydb-cluster=DEST_CLUSTER \
     --username=DEST_USER \
     --password=DEST_PASSWORD \
     --role=DESTINATION \
     --no-async

   Windows（PowerShell）

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID `
     --region=REGION `
     --alloydb-cluster=DEST_CLUSTER `
     --username=DEST_USER `
     --password=DEST_PASSWORD `
     --role=DESTINATION `
     --no-async

   Windows（cmd.exe）

   gcloud database-migration connection-profiles create postgresql DEST_CONN_ID ^
     --region=REGION ^
     --alloydb-cluster=DEST_CLUSTER ^
     --username=DEST_USER ^
     --password=DEST_PASSWORD ^
     --role=DESTINATION ^
     --no-async

   次のようなレスポンスが返されます。

   Waiting for connection profile [CONNECTION_PROFILE_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created connection profile CONNECTION_PROFILE_ID [OPERATION_ID]
   

6. 移行ジョブを作成します。
   次のコマンドを実行して、継続的移行ジョブを作成します（クリックして展開）。

   gcloud database-migration migration-jobs create

   このサンプルでは、すべてのオペレーションが同期的に実行されるように、オプションの --no-async フラグを使用しています。そのため、一部のコマンドの完了に時間がかかることがあります。--no-async フラグを省略して、コマンドを非同期で実行できます。その場合は、gcloud database-migration operations describe コマンドを使用して、オペレーションが成功したかどうかを確認する必要があります。

   後述のコマンドデータを使用する前に、次のように置き換えます。

   • MIGRATION_JOB_ID は、移行ジョブの ID に置き換えます。
   • REGION: 移行ジョブを保存するリージョン。
   • SOURCE_CONN_ID は、ソース接続プロファイルの ID に置き換えます。
   • DEST_CONN_ID は、宛先接続プロファイルの識別子に置き換えます。
   • DATABASES_LIST は、移行するデータベースのカンマ区切りのリストに置き換えます。

   次のコマンドを実行します。

   Linux、macOS、Cloud Shell

   gcloud database-migration migration-jobs create \
     MIGRATION_JOB_ID \
     --region=REGION \
     --type=CONTINUOUS \
     --source=SOURCE_CONN_ID \
     --destination=DEST_CONN_ID \
     --use-postgres-native \
     --postgres-max-additional-subscriptions=10 \
     --databases-filter=DATABASES_LIST \
     --no-async

   Windows（PowerShell）

   gcloud database-migration migration-jobs create `
     MIGRATION_JOB_ID `
     --region=REGION `
     --type=CONTINUOUS `
     --source=SOURCE_CONN_ID `
     --destination=DEST_CONN_ID `
     --use-postgres-native `
     --postgres-max-additional-subscriptions=10 `
     --databases-filter=DATABASES_LIST `
     --no-async

   Windows（cmd.exe）

   gcloud database-migration migration-jobs create ^
     MIGRATION_JOB_ID ^
     --region=REGION ^
     --type=CONTINUOUS ^
     --source=SOURCE_CONN_ID ^
     --destination=DEST_CONN_ID ^
     --use-postgres-native ^
     --postgres-max-additional-subscriptions=10 ^
     --databases-filter=DATABASES_LIST ^
     --no-async

   次のようなレスポンスが返されます。

   Waiting for migration job [MIGRATION_JOB_ID]
   to be created with [OPERATION_ID]
   
   Waiting for operation [OPERATION_ID] to complete...done.
   
   Created migration job MIGRATION_JOB_ID [OPERATION_ID]
   

7. 移行ジョブを開始します。
   移行ジョブを開始するには、次のコマンドを実行します（クリックして展開）。

   gcloud database-migration migration-jobs start

   gcloud database-migration migration-jobs start MIGRATION_JOB_ID \
     --region=REGION