Migra de Cloud SQL para PostgreSQL a AlloyDB para PostgreSQL

Console

1. En la Cloud de Confiance consola de, ve a la página Clústeres.
   

   Ir a los clústeres

2. Haz clic en Migrar datos y, luego, selecciona Copiar desde Cloud SQL Backup.
3. En la página Copiar desde la copia de seguridad de Cloud SQL, habilita las APIs requeridas. Si ya habilitaste las APIs, no es necesario que lo vuelvas a hacer.
4. En la página Seleccionar el tipo de clúster, selecciona Clúster aprovisionado.
5. Haz clic en Seleccionar tipo de clúster.
6. Selecciona la instancia de Cloud SQL desde la que deseas copiar una copia de seguridad de y, luego, haz clic en Seleccionar instancia. Puedes filtrar instancias de Cloud SQL.
   Solo se muestran las versiones de bases de datos compatibles. Las réplicas no tienen copias de seguridad y no se muestran en la lista de instancias disponibles.
7. Selecciona la copia de seguridad que deseas importar y, luego, haz clic en Select backup. En esta página, se muestran las 1,000 copias de seguridad más recientes.
8. En la página Crea tu clúster aprovisionado, ingresa tu información de red. El ID del clúster se propaga de forma predeterminada, pero también puedes personalizar tu clúster aprovisionado.
9. Haz clic en Crear clúster.

Una vez que se completa la operación, se crea automáticamente una instancia principal. Verás un nuevo clúster de AlloyDB con los datos copiados de la copia de seguridad de Cloud SQL para PostgreSQL que seleccionaste.

Cuando copias una copia de seguridad de Cloud SQL para PostgreSQL en un clúster de AlloyDB, las marcas de la base de datos se migran si están en Cloud SQL para PostgreSQL y en AlloyDB. Los permisos a nivel de recursos no se migran automáticamente. Una vez que se complete la copia, debes configurar de forma manual los permisos y las marcas de la base de datos que no se migraron debido a una falta de coincidencia.

Puedes verificar qué marcas de base de datos en Cloud SQL para PostgreSQL son compatibles con AlloyDB en la página Crea tu clúster aprovisionado.

gcloud

Para usar la CLI de gcloud, puedes instalarla e inicializarla o bien usar Cloud Shell.

1. Ejecuta el comando gcloud beta alloydb clusters migrate-cloud-sql:
   

         gcloud beta 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
         

   Reemplaza lo siguiente:

   • CLUSTER_ID: Es el ID del clúster de Cloud SQL para PostgreSQL.
   • CLOUD_SQL_BACKUP_ID: Es el ID de la copia de seguridad de Cloud SQL desde la que se migrará. Debe ser el ID de la copia de seguridad.
   • CLOUD_SQL_INSTANCE_ID: Es el ID de la instancia de Cloud SQL desde la que se migrará. Debe ser el ID de la instancia.
   • CLOUD_SQL_PROJECT_ID: Es el ID del proyecto de Cloud SQL desde el que se migrará. Debe ser el ID del proyecto.
   • PASSWORD: Es la contraseña inicial del usuario de PostgreSQL que se configurará durante la creación del clúster.
   • REGION: Es la ubicación, por ejemplo, asia-east1 o us-east1. Consulta la lista completa de regiones en ubicaciones regionales.
   • DATABASE_VERSION: Es la versión de la base de datos del clúster. Debe ser una de las siguientes: POSTGRES_14, POSTGRES_15, POSTGRES_16 o POSTGRES_17. La versión de la base de datos debe ser la misma que la versión de la copia de seguridad de Cloud SQL.
   • SUBSCRIPTION_TYPE: Es el tipo de suscripción del clúster. Debe ser una de las siguientes: STANDARD o TRIAL.
2. Ejecuta el comando gcloud beta alloydb operations describe para confirmar el estado de la operación de copia de seguridad:
   

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

   Reemplaza lo siguiente:

   • OPERATION_ID: Es el nombre de la operación de Cloud SQL para PostgreSQL.
   • REGION_ID: Es la región en la que se implementa el clúster de Cloud SQL para PostgreSQL.
   • PROJECT_ID: Es el ID del proyecto.
3. Usa el comando gcloud alloydb instances create para crear una instancia principal.

API de REST

1. Para obtener una lista de las copias de seguridad de la instancia desde la que deseas restablecer tu copia de seguridad, llama al backupsRuns.list método:
   

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

   Reemplaza lo siguiente:

   • PROJECT_ID: Es el ID del proyecto.
   • INSTANCE_ID: El ID de la instancia.

   Cuerpo JSON de la solicitud:

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

   Para enviar tu solicitud, usa una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   En el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien usando Cloud Shell, que te permite acceder automáticamente a gcloud CLI.

   Puedes verificar la cuenta activa ejecutando gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

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

   PowerShell (Windows)

   En el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien usando Cloud Shell, que te permite acceder automáticamente a gcloud CLI.

   Puedes verificar la cuenta activa ejecutando gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta la siguiente orden:

            $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//sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns"|Select-Object -Expand Content
         

   Recibirás una respuesta JSON similar a la siguiente:

   Respuesta

   Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una lista de BackupRun.

   La respuesta de la API muestra una lista de copias de seguridad de la instancia como una lista de arrays, incluido "id": string,.

2. Llama al método restoreFromCloudSQL:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: Es el ID del proyecto.
   • REGION: Es la región en la que se implementa el clúster de AlloyDB.

   Cuerpo JSON de la solicitud:

         {
           "clusterId": string,
           "cluster": {
             "databaseVersion": "POSTGRES_14/POSTGRES_15/POSTGRES_16/POSTGRES_17",
             "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.
         }
         

   Para enviar tu solicitud, usa una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   En el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien usando Cloud Shell, que te permite acceder automáticamente a gcloud CLI.

   Puedes verificar la cuenta activa ejecutando gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta la siguiente orden:

           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/v1beta/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"
         

   PowerShell (Windows)

   En el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloudauth login, o bien usando Cloud Shell, que te permite acceder automáticamente a gcloud CLI.

   Puedes verificar la cuenta activa ejecutando gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta la siguiente orden:

           $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/v1beta/projects/PROJECT_ID/locations/REGION/clusters:restoreFromCloudSQL"|Select-Object -Expand Content
         

   Recibirás una respuesta JSON similar a la siguiente:

   Respuesta

   Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

   Se crea un clúster nuevo en el proyecto y la ubicación especificados, con un volumen restablecido desde la copia de seguridad indicada en el mensaje CloudSQLBackupRunSource.

3. Cuando el clúster esté en estado READY, crea la instancia principal llamando al projects.locationsinstances.create método:
   

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

   Reemplaza lo siguiente:

   • PROJECT_ID: Es el ID del proyecto.
   • REGION: Es la región en la que se implementa el clúster de AlloyDB.
   • CLUSTER_ID: Es el ID del clúster.

   Cuerpo JSON de la solicitud:

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

   El cuerpo de la solicitud contiene una instancia de Instance.

   Para enviar tu solicitud, usa una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   En el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien usando Cloud Shell, que te permite acceder automáticamente a gcloud CLI.

   Puedes verificar la cuenta activa ejecutando gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta la siguiente orden:

           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/v1beta/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"
         

   PowerShell (Windows)

   En el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario ejecutando gcloud init o gcloud auth login, o bien usando Cloud Shell, que te permite acceder automáticamente a gcloud CLI.

   Puedes verificar la cuenta activa ejecutando gcloud auth list.

   Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta la siguiente orden:

            $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/v1beta/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID/instances"|Select-Object -Expand Content
         

   Recibirás una respuesta JSON similar a la siguiente:

   Respuesta

   Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Operation.

4. Después de que la instancia se actualice al estado READY, conéctate a ella y accede a los datos restablecidos desde la instantánea de Cloud SQL.