Esegui l'upgrade della versione secondaria del database

MySQL   |  PostgreSQL   |  SQL Server

Questa pagina descrive come eseguire l'upgrade della versione secondaria di un'istanza MySQL. Per le versioni supportate, vedi Versioni del database e criteri di versione.

Nota: per eseguire l'upgrade della versione principale di un database, consulta Eseguire l'upgrade della versione principale del database eseguendo la migrazione dei dati o Eseguire l'upgrade della versione principale del database sul posto.

Con ogni nuova versione minore, i fornitori di database rilasciano nuove funzionalità, patch di sicurezza, correzioni di bug e miglioramenti delle prestazioni. Inoltre, Cloud SQL aggiorna regolarmente la versione secondaria durante la manutenzione.

Tuttavia, MySQL 8.0 non supporta il downgrade. Di conseguenza, gli upgrade delle versioni secondarie non sono incluse automaticamente nella manutenzione di routine. Puoi specificare la versione minore per Cloud SQL per MySQL 8.0 durante la creazione di un'istanza o in un secondo momento tramite una procedura di upgrade, entrambe descritte in questa pagina.

Prima di eseguire l'upgrade a una nuova versione secondaria di MySQL 8.0, acquisisci familiarità con le modifiche. Consulta le note di rilascio di MySQL 8.0. Se utilizzi Cloud SQL per MySQL 5.6 o 5.7, Cloud SQL gestisce automaticamente la versione minore dell'istanza. Quando esegui il provisioning di una nuova istanza, Cloud SQL configura automaticamente l'istanza con il database più recente completamente gestita. Durante la manutenzione di routine, Cloud SQL esegue l'upgrade dell'istanza all'ultima versione supportata.

Per eseguire l'upgrade della versione secondaria del database dell'istanza MySQL 8.0, devi aggiorna l'istanza con la versione secondaria che preferisci, che deve essere superiore rispetto alla versione secondaria installata. Non puoi ripristinare una versione minore non specificata dopo il provisioning di un'istanza.

Se esegui un'istanza Cloud SQL nella versione Enterprise Plus, l'upgrade della versione minore viene completato con tempi di inattività quasi nulli.

Prima di eseguire l'upgrade

Cloud SQL supporta l'upgrade della versione secondaria per le istanze MySQL 8.0. MySQL 8.0 non consente i downgrade. Pertanto, prima di eseguire l'upgrade dell'istanza principale, segui questi passaggi per assicurarti che i tuoi dati siano al sicuro.

1. Scegli la versione secondaria di destinazione del database.

   gcloud

   Per informazioni su come installare e iniziare a utilizzare gcloud CLI, consulta Installare gcloud CLI. Per informazioni su come avviare Cloud Shell, consulta Utilizzare Cloud Shell.

   Per controllare quali versioni secondarie del database sono disponibili per un upgrade in situ: segui questi passaggi:

   1. Esegui questo comando.

   gcloud sql instances describe INSTANCE_NAME
      

   Sostituisci INSTANCE_NAME con il nome dell'istanza.

   2. Nell'output del comando, individua la sezione etichettata upgradableDatabaseVersions.
   3. Ogni sottosezione restituisce una versione del database disponibile per l'upgrade. In ogni sottosezione, rivedi il campo seguente.
   • name: la stringa della versione del database che include la versione maggiore e minore del database che puoi scegliere come target per l'upgrade in situ della versione minore di Cloud SQL per MySQL.

   REST v1

   Per verificare quali versioni secondarie del database sono disponibili per un upgrade in loco, utilizza la Metodo instances.get dell'API Cloud SQL Admin.

   Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

   • INSTANCE_NAME: il nome dell'istanza.

   Metodo HTTP e URL:

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

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

   Esegui questo comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

   Esegui questo comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   
   upgradableDatabaseVersions:
   
   {
     major_version: "MYSQL_8_0"
     name: "MYSQL_8_0_36"
     display_name: "MySQL 8.0.36"
   }
   
   

   REST v1beta4

   Per verificare quali versioni secondarie del database sono disponibili per un upgrade in loco, utilizza la Metodo instances.get dell'API Cloud SQL Admin.

   Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

   • INSTANCE_NAME: il nome dell'istanza.

   Metodo HTTP e URL:

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   Per inviare la richiesta, espandi una di queste opzioni:

   curl (Linux, macOS o Cloud Shell)

   Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

   Esegui questo comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

   Esegui questo comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Dovresti ricevere una risposta JSON simile alla seguente:

   
   upgradableDatabaseVersions:
   
   {
     major_version: "MYSQL_8_0"
     name: "MYSQL_8_0_36"
     display_name: "MySQL 8.0.36"
   }
   
   

   Per l'elenco completo delle versioni del database supportate da Cloud SQL, consulta Versioni del database e criteri di versione.

2. Esegui il test dell'upgrade in un ambiente di staging.

   1. Crea un clone dell'istanza di produzione da utilizzare come istanza temporanea. Questo crea una nuova istanza di database con le stesse versioni principali e secondarie.

   2. Esegui un upgrade della versione secondaria nell'istanza di staging.

   3. Esegui test dei carichi di lavoro per verificare che l'upgrade sia riuscito e che l'applicazione funzioni come previsto. Se il test va a buon fine, procedi con l'upgrade delle istanze di replica di lettura.

3. Esegui l'upgrade delle istanze di replica di lettura.

   1. Esegui l'upgrade di tutte le repliche di lettura nel database alla versione secondaria di destinazione.

   2. Verifica che l'applicazione funzioni come previsto.

4. Esegui il backup dell'istanza principale.

   Come per qualsiasi aggiornamento significativo del database, esegui un backup dell'istanza principale.

Esegui l'upgrade della versione secondaria

Puoi specificare la versione secondaria del database di un'istanza esistente utilizzando gcloud o l'API REST. Esegui gli upgrade delle versioni secondarie quando il database non è in uso. Se l'istanza richiede un riavvio, si verificherà un certo tempo di inattività. Istanze della versione Cloud SQL Enterprise Plus con tempi di inattività prossimi allo zero. Se la versione installata è successiva a quella richiesta, la richiesta viene rifiutata.

Nota: durante l'upgrade della versione secondaria del database non sono consentiti aggiornamenti simultanei, ad esempio l'aggiornamento delle dimensioni del disco o della memoria di un'istanza.

gcloud

Utilizza il comando gcloud sql instances patch con il flag --database-version.

Sostituisci le seguenti variabili prima di eseguire il comando:

• INSTANCE_NAME: il nome dell'istanza.
• DATABASE_VERSION: la versione del database dell'istanza. Se non specifichi questo flag, viene usata la versione principale predefinita.

gcloud sql instances patch INSTANCE_NAME \
   --database-version=DATABASE_VERSION

REST v1

Utilizza una richiesta PATCH con il metodo instances:patch e il flag databaseVersion.

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza
• DATABASE_VERSION: la versione del database a cui eseguire l'upgrade.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "databaseVersion": "DATABASE_VERSION"
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

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

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Utilizza una richiesta PATCH con il metodo instances:patch e il flag databaseVersion.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

• PROJECT_ID: l'ID progetto
• INSTANCE_ID: l'ID istanza
• DATABASE_VERSION: la versione del database a cui eseguire l'upgrade.

Metodo HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID

Corpo JSON della richiesta:

{
  "databaseVersion": "DATABASE_VERSION"
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

curl (Linux, macOS o Cloud Shell)

Nota: Il comando seguente presuppone che tu abbia eseguito l'accesso a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

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

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

PowerShell (Windows)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list

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

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT-ID/instances/INSTANCE_ID" | Select-Object -Expand Content

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2022-07-17T20:23:15.540Z",
  "operationType": "UPDATE",
  "name": "fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetId": "INSTANCE-ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/fa3f7304-ccf6-4d2f-a6f5-24df00000032",
  "targetProject": "PROJECT_ID"
}

Controlla la versione minore del database installata

Quando visualizzi le informazioni di riepilogo dell'istanza, la versione minore del database installata è visibile nella sezione Configurazione.

Esegui il rollback di un upgrade

Se noti un problema durante il test di un upgrade, puoi eseguire il rollback il tuo database per recuperare l'istanza di database che esegue la versione secondaria precedente.

Per ripristinare un backup prima dell'upgrade, segui questi passaggi:

1. Esegui il provisioning di un'istanza di database di recupero sulla versione secondaria precedente.
2. Configura le impostazioni dell'istanza del database di recupero nello stato precedente all'upgrade.
3. Ripristina il backup eseguito prima dell'upgrade nell'istanza di recupero.

Nota: quando ripristini un'istanza da un backup a un'istanza di destinazione, la versione installata del backup viene confrontata dell'istanza del database di destinazione. Poiché MySQL 8.0 non consente il downgrade, se il backup ha una versione installata superiore a quella del target, la richiesta di ripristino viene rifiutata.

In alternativa al ripristino di un backup, esegui un recupero point-in-time e crea una nuova istanza.