Cloud SQL for PostgreSQL から AlloyDB for PostgreSQL に移行する

コンソール

1. Cloud de Confiance コンソールで、[クラスタ] ページに移動します。
   

   [クラスタ] に移動

2. [データを移行] をクリックし、[Cloud SQL バックアップからコピー] を選択します。
3. [Cloud SQL バックアップからコピー] ページで、必要な API を有効にします。API をすでに有効にしている場合は、API を再度有効にする必要はありません。
4. [クラスタタイプの選択] ページで、[プロビジョニング済みのクラスタ] を選択します。
5. [クラスタタイプの選択] をクリックします。
6. バックアップのコピー元の Cloud SQL インスタンスを選択し、[インスタンスの選択] をクリックします。Cloud SQL インスタンスをフィルタできます。
   互換性のあるデータベース バージョンのみが表示されます。レプリカにはバックアップがなく、使用可能なインスタンスのリストには表示されません。
7. インポート元のバックアップを選択し、[バックアップの選択] をクリックします。このページには、最新の 1,000 件のバックアップが表示されます。
8. [プロビジョニング済みクラスタの作成] ページで、ネットワーキング情報を入力します。クラスタ ID はデフォルトで入力されますが、プロビジョニングされたクラスタをカスタマイズすることもできます。
9. [クラスタを作成] をクリックします。

オペレーションが完了すると、プライマリ インスタンスが自動的に作成されます。選択した Cloud SQL for PostgreSQL バックアップからコピーされたデータを含む、新しい AlloyDB クラスタが表示されます。

Cloud SQL for PostgreSQL のバックアップを AlloyDB クラスタにコピーすると、データベース フラグが Cloud SQL for PostgreSQL と AlloyDB にある場合は、データベース フラグが移行されます。リソースレベルの権限は自動的に移行されません。コピーが完了したら、権限と、不一致が原因で移行されなかったデータベース フラグを手動で設定する必要があります。

AlloyDB でサポートされている Cloud SQL for PostgreSQL のデータベース フラグについては、プロビジョニングされたクラスタを作成するをご覧ください。

gcloud

gcloud CLI を使用するには、gcloud CLI をインストールして初期化するか、Cloud Shell を使用します。

1. gcloud alloydb clusters migrate-cloud-sql コマンドを実行します。
   

         gcloud alloydb clusters migrate-cloud-sql CLUSTER_ID \
           --cloud-sql-backup-id=CLOUD_SQL_BACKUP_ID \
           --cloud-sql-instance-id=CLOUD_SQL_INSTANCE_ID \
           --cloud-sql-project-id=CLOUD_SQL_PROJECT_ID \
           --password=PASSWORD \
           --region=REGION \
           --database-version=DATABASE_VERSION \
           --subscription-type=STANDARD
         

   次のように置き換えます。

   • CLUSTER_ID: Cloud SQL for PostgreSQL クラスタ ID。
   • CLOUD_SQL_BACKUP_ID: 移行元の Cloud SQL バックアップ ID。これはバックアップ ID にする必要があります。
   • CLOUD_SQL_INSTANCE_ID: 移行元の Cloud SQL インスタンス ID。これはインスタンス ID にする必要があります。
   • CLOUD_SQL_PROJECT_ID: 移行元の Cloud SQL プロジェクト ID。これはプロジェクト ID にする必要があります。
   • PASSWORD: クラスタの作成時に設定する PostgreSQL ユーザーの初期パスワード。
   • REGION: ロケーション（例: asia-east1、us-east1）。リージョンの一覧については、ロケーションをご覧ください。
   • DATABASE_VERSION: クラスタのデータベース バージョン。POSTGRES_14、POSTGRES_15、POSTGRES_16、POSTGRES_17、POSTGRES_18 のいずれかにする必要があります。データベース バージョンは、Cloud SQL バックアップのバージョンと同じである必要があります。
2. gcloud alloydb operations describe コマンドを実行して、バックアップ オペレーションのステータスを確認します。
   

         gcloud alloydb operations describe OPERATION_ID \
           --region=REGION_ID \
           --project=PROJECT_ID
         

   次のように置き換えます。

   • OPERATION_ID: Cloud SQL for PostgreSQL オペレーションの名前。
   • REGION_ID: Cloud SQL for PostgreSQL クラスタがデプロイされるリージョン。
   • PROJECT_ID: プロジェクト ID。
3. gcloud alloydb instances create コマンドを使用して、プライマリ インスタンスを作成します。

REST API

1. バックアップを復元するインスタンスのバックアップのリストを取得するには、backupRuns.list メソッドを呼び出します。
   

         GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns
         

   次のように置き換えます。

   • PROJECT_ID: プロジェクト ID。
   • INSTANCE_ID: インスタンス ID。

   リクエストを送信するには、次のいずれかのオプションを使用します。

   curl（Linux、macOS、Cloud Shell）

   次のコマンドは、gcloud init または gcloud auth login を実行してユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して gcloud CLI に自動的にログインしていることを前提としています。

   gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

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

           curl -X GET \
                  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
                  -H "Content-Type: application/json; charset=utf-8" \
                  "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns"
           

   PowerShell（Windows）

   次のコマンドは、gcloud init または gcloud auth login を実行してユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して gcloud CLI に自動的にログインしていることを前提としています。

   gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

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

            $cred = gcloud auth print-access-token
            $headers = @{ "Authorization" = "Bearer $cred" }
            Invoke-WebRequest \
             -Method GET \
             -Headers $headers \
             -ContentType: "application/json; charset=utf-8" \
             -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns" | Select-Object -Expand Content
         

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

   レスポンス

   成功した場合、レスポンスの本文には BackupRun オブジェクトのリストが含まれます。

         {
           "kind": string,
           "items": [
             {
               object (BackupRun)
             }
           ],
           "nextPageToken": string
         }
         

   API レスポンスは、"id": string を含むインスタンスのバックアップのリストを配列リストとして返します。

2. clusters.restoreFromCloudSQL メソッドを呼び出します。

           POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL
         

   次のように置き換えます。

   • PROJECT_ID: プロジェクト ID。
   • REGION: AlloyDB クラスタがデプロイされているリージョン。

   リクエストの本文（JSON）:

         {
           "clusterId": string,
           "cluster": {
             "databaseVersion": "POSTGRES_14/POSTGRES_15/POSTGRES_16/POSTGRES_17/POSTGRES_18",
             "subscriptionType": "STANDARD"
           },
           // Union field source can be only one of the following:
           "cloudsqlBackupRunSource": {
             object (CloudSQLBackupRunSource)
           }
           // End of list of possible types for union field source.
         }
         

   リクエストを送信するには、次のいずれかのオプションを使用します。

   curl（Linux、macOS、Cloud Shell）

   次のコマンドは、gcloud init または gcloud auth login を実行してユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して gcloud CLI に自動的にログインしていることを前提としています。

   gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

           curl -X POST \
                  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
                  -H "Content-Type: application/json; charset=utf-8" \
                  -d @request.json \
                  "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"
         

   PowerShell（Windows）

   次のコマンドは、gcloud init または gcloud auth login を実行してユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して gcloud CLI に自動的にログインしていることを前提としています。

   gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

           $cred = gcloud auth print-access-token
           $headers = @{ "Authorization" = "Bearer $cred" }
           Invoke-WebRequest \
             -Method POST \
             -Headers $headers \
             -ContentType: "application/json; charset=utf-8" \
             -InFile request.json \
             -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"|Select-Object -Expand Content
         

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

   レスポンス

   成功した場合、レスポンスの本文には Operation のインスタンスが含まれます。

   AlloyDB は、指定されたプロジェクトとロケーションに新しいクラスタを作成し、CloudSQLBackupRunSource メッセージで指定されたバックアップからボリュームを復元します。

3. クラスタが READY 状態の場合は、projects.locations.clusters.instances.create メソッドを呼び出してプライマリ インスタンスを作成します。
   

         POST https://alloydb.googleapis.com/v1/{parent=projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID}/instances
         

   次のように置き換えます。

   • PROJECT_ID: プロジェクト ID。
   • REGION: AlloyDB クラスタがデプロイされているリージョン。
   • CLUSTER_ID: クラスタ ID。

   リクエストの本文（JSON）:

           {
             "instanceId": "string",
             "instance": {
               "object": "Instance"
             }
           }
         

   リクエストの本文には Instance のインスタンスが含まれます。

   リクエストを送信するには、次のいずれかのオプションを使用します。

   curl（Linux、macOS、Cloud Shell）

   次のコマンドは、gcloud init または gcloud auth login を実行してユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して gcloud CLI に自動的にログインしていることを前提としています。

   gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

           curl -X POST \
                -H "Authorization: Bearer $(gcloud auth print-access-token)" \
                -H "Content-Type: application/json; charset=utf-8" \
                -d @request.json \
                "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"
         

   PowerShell（Windows）

   次のコマンドは、gcloud init または gcloud auth login を実行してユーザー アカウントで gcloud CLI にログインしているか、Cloud Shell を使用して gcloud CLI に自動的にログインしていることを前提としています。

   gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

   リクエスト本文を request.json という名前のファイルに保存して、次のコマンドを実行します。

            $cred = gcloud auth print-access-token
            $headers = @{ "Authorization" = "Bearer $cred" }
            Invoke-WebRequest \
              -Method POST \
              -Headers $headers \
              -ContentType: "application/json; charset=utf-8" \
              -InFile request.json \
              -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"|Select-Object -Expand Content
         

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

   レスポンス

   成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

4. インスタンスが READY 状態に更新されたら、インスタンスに接続し、Cloud SQL スナップショットから復元されたデータにアクセスします。