Esegui la migrazione da Cloud SQL per PostgreSQL ad AlloyDB per PostgreSQL

Anteprima - AlloyDB for PostgreSQL

Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini generali del servizio dei Termini specifici dei servizi. L'utente può trattare i dati personali relativi a questa funzionalità come descritto nell'Addendum per il trattamento dei dati Cloud, in conformità agli obblighi e alle limitazioni descritti nel contratto in base al quale accede a Google Cloud. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Standard Prova gratuita

Questa pagina descrive come eseguire la migrazione di un'istanza Cloud SQL per PostgreSQL copiando un backup di Cloud SQL in un clusterAlloyDB per PostgreSQL. La copia di un backup di Cloud SQL in un cluster AlloyDB ti consente di caricare rapidamente i dati in AlloyDB per PostgreSQL, il che ti consente di valutare o eseguire la migrazione in AlloyDB.

Questa pagina presuppone la conoscenza di Cloud SQL. Se non hai mai utilizzato AlloyDB, consulta la panoramica di AlloyDB.

Per scoprire come eseguire la migrazione dei dati da Cloud SQL ad AlloyDB utilizzando la replica dei dati continua, consulta Database Migration Service per la migrazione da PostgreSQL ad AlloyDB.

Non è supportato quanto segue:

• Ripristini tra progetti e regioni
• Istanze con chiavi di crittografia gestite dal cliente (CMEK)
• Istanze con autenticazione di gruppo Identity and Access Management (IAM)

Prima di iniziare

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Enable the AlloyDB, Compute Engine, and Service Networking APIs.

   Enable the APIs

7. Assicurati di avere quanto segue:
   
   • Le autorizzazioni IAM (Identity and Access Management) necessarie
   • Un backup di Cloud SQL di dimensioni inferiori a 5 TB
   • Una versione di PostgreSQL supportata da AlloyDB

Ruoli obbligatori

Nota: non puoi utilizzare i ruoli Cloud SQL personalizzati per eseguire la migrazione di un'istanza Cloud SQL per PostgreSQL copiando il backup di Cloud SQL in un cluster AlloyDB.

Per ottenere le autorizzazioni necessarie per copiare un backup di Cloud SQL per PostgreSQL in un cluster AlloyDB, concedi a te stesso i seguenti ruoli IAM nel progetto:

• Visualizzatore (roles/viewer)
• Cloud AlloyDB Admin (roles/alloydb.admin)

Copiare un backup di Cloud SQL in un cluster AlloyDB

La copia di un backup di Cloud SQL in un cluster AlloyDB standard in prova gratuita consente di ripristinare il backup nella stessa versione di PostgreSQL su AlloyDB, ad esempio un backup di Cloud SQL di PostgreSQL 14 viene ripristinato in un cluster PostgreSQL standard. Tieni presente che le versioni di estensione e le versioni minori di PostgreSQL potrebbero essere diverse.

La copia di un backup da Cloud SQL supporta solo la configurazione di quegli elementi supportati nel clusterstandard di prova gratuita di AlloyDB.

Nota: non puoi copiare un backup se è superiore a 5TB.

Per copiare un backup di Cloud SQL in un cluster AlloyDB standard in prova gratuita:

Console

1. Nella console Google Cloud, vai alla pagina Cluster.
   

   Vai a Cluster

2. Fai clic su Esegui la migrazione dei dati e poi seleziona Copia dal backup di Cloud SQL.
3. Nella pagina Copia dal backup di Cloud SQL, abilita le API richieste. Se hai già attivato le API, non è necessario riattivarle.
4. Nella pagina Seleziona il tipo di cluster, seleziona Cluster di cui è stato eseguito il provisioning.
5. Fai clic su Seleziona il tipo di cluster.
6. Seleziona l'istanza Cloud SQL da cui vuoi copiare un backup, quindi fai clic su Seleziona istanza. Puoi filtrare le istanze Cloud SQL.
   Vengono visualizzate solo le versioni del database compatibili. Le repliche non hanno backup e non vengono visualizzate nell'elenco delle istanze disponibili.
7. Seleziona il backup da cui vuoi eseguire l'importazione e poi fai clic su Seleziona backup. Questa pagina mostra i 1000 backup più recenti.
8. Nella pagina Crea il tuo cluster di cui è stato eseguito il provisioning, inserisci le informazioni di rete. L'ID cluster viene compilato per impostazione predefinita, ma puoi anche personalizzare il cluster di cui è stato eseguito il provisioning.
9. Fai clic su Crea cluster.

Al termine dell'operazione, viene creata automaticamente un'istanza principale. Viene visualizzato un nuovo cluster AlloyDB con i dati copiati dal backup di Cloud SQL per PostgreSQL selezionato.

Quando copi un backup di Cloud SQL per PostgreSQL in un cluster AlloyDB, viene eseguita la migrazione dei flag del database se sono presenti in Cloud SQL per PostgreSQL e in AlloyDB. La migrazione delle autorizzazioni a livello di risorsa non viene eseguita automaticamente. Al termine della copia, devi configurare manualmente le autorizzazioni e gli indicatori del database di cui non è stata eseguita la migrazione a causa di una mancata corrispondenza.

Puoi controllare quali flag di database in Cloud SQL per PostgreSQL sono supportati in AlloyDB nella pagina Crea il cluster di cui è stato eseguito il provisioning.

API REST

1. Per ottenere un elenco dei backup per l'istanza da cui vuoi ripristinare il backup, chiama il metodo backupsRuns.list:
   

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • INSTANCE_ID: l'ID istanza.

   Corpo JSON della richiesta:

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

   Per inviare la richiesta, utilizza una delle seguenti opzioni:

   curl (Linux, macOS o Cloud Shell)

   Il seguente comando presuppone che tu abbia eseguito l'accesso a Google Cloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente a gcloud CLI.

   Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente 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)

   Il seguente comando presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente a gcloud CLI.

   Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

            $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
         

   Riceverai una risposta JSON simile alla seguente:

   Risposta

   In caso di esito positivo, il corpo della risposta contiene un elenco di BackupRun.

   La risposta dell'API restituisce un elenco di backup per l'istanza come elenco di array, incluso "id": string,.

2. Chiama il metodo restoreFromCloudSQL:

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • REGION: la regione in cui è disegnato il cluster AlloyDB.

   Corpo JSON della richiesta:

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

   Per inviare la richiesta, utilizza una delle seguenti opzioni:

   curl (Linux, macOS o Cloud Shell)

   Il seguente comando presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente a gcloud CLI.

   Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

           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)

   Il seguente comando presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloudauth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente a gcloud CLI.

   Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

           $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
         

   Riceverai una risposta JSON simile alla seguente:

   Risposta

   In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation.

   Viene creato un nuovo cluster nel progetto e nella posizione specificati, con un volume ripristinato dal backup indicato nel messaggio CloudSQLBackupRunSource.

3. Quando il cluster è in uno stato READY, crea l'istanza principale chiamando il metodo projects.locationsinstances.create:
   

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

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID progetto.
   • REGION: la regione in cui è disegnato il cluster AlloyDB.
   • CLUSTER_ID: l'ID cluster.

   Corpo JSON della richiesta:

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

   Il corpo della richiesta contiene un'istanza di Instance.

   Per inviare la richiesta, utilizza una delle seguenti opzioni:

   curl (Linux, macOS o Cloud Shell)

   Il seguente comando presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente a gcloud CLI.

   Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

           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)

   Il seguente comando presuppone che tu abbia eseguito l'accesso a gcloud CLI con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente a gcloud CLI.

   Puoi controllare l'account attivo eseguendo gcloud auth list.

   Salva il corpo della richiesta in un file denominato request.json ed esegui il seguente comando:

            $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
         

   Riceverai una risposta JSON simile alla seguente:

   Risposta

   In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di Operation.

4. Dopo che l'istanza è stata aggiornata allo stato READY, connettiti all'istanza e accedi ai dati ripristinati dallo snapshot di Cloud SQL.

Passaggi successivi

• Connettiti ad AlloyDB utilizzando l'IP pubblico.
• Gestisci i tuoi dati utilizzando AlloyDB Studio.