Esegui l'upgrade di un'istanza alla versione Cloud SQL Enterprise Plus utilizzando l'upgrade in loco


Questa pagina mostra come utilizzare il metodo di upgrade in loco per eseguire l'upgrade di una versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus. Inoltre, descrive la procedura per eseguire il downgrade di una versione Cloud SQL Enterprise Plus alla versione Cloud SQL Enterprise.

L'upgrade alla versione Cloud SQL Enterprise Plus offre diversi vantaggi e miglioramenti delle prestazioni. Per saperne di più, consulta Introduzione alle versioni di Cloud SQL per MySQL.

Per abilitare questi miglioramenti per le istanze esistenti della versione Cloud SQL Enterprise, devi eseguire l'upgrade a Cloud SQL Enterprise Plus. Il completamento del processo di upgrade richiede alcuni minuti con un inferiore a 60 secondi. Inoltre, questo processo non le applicazioni devono modificare gli endpoint a cui si connettono.

Prima di iniziare

  • Assicurati che l'istanza utilizzi un'unità a stato solido (SSD).

Controlla la posizione di archiviazione dei log delle transazioni utilizzati per il PITR

Tutte le istanze della versione Cloud SQL Enterprise Plus sono abilitate automaticamente con il point-in-time il ripristino di emergenza (PITR). Se l'istanza della versione Cloud SQL Enterprise di cui vuoi eseguire l'upgrade archivia i log binari usati per il PITR su disco, quindi il processo di upgrade alla versione Cloud SQL Enterprise Plus cambia la posizione di archiviazione log binari dal disco a Cloud Storage.

Prima di eseguire l'upgrade alla versione Cloud SQL Enterprise Plus, controlla se la tua versione Cloud SQL Enterprise l'istanza verrà sottoposta all'opzione di posizione di archiviazione per i log binari utilizzati per PITR. Per ulteriori informazioni e istruzioni su come controllare l'istanza, vedi Controllare la posizione di archiviazione dei log delle transazioni utilizzati per PITR.

Per ulteriori informazioni su come cambiare la posizione di archiviazione dei log delle transazioni durante il processo di upgrade, consulta Posizione di archiviazione dei log delle transazioni utilizzati per il PITR.

Esegui l'upgrade di un'istanza alla versione Cloud SQL Enterprise Plus

Utilizza la procedura in questa sezione per eseguire l'upgrade di un'istanza della versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus.

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Modifica.
  4. Nella sezione Scegli una versione di Cloud SQL, fai clic su Esegui l'upgrade.
  5. Nel riquadro Esegui l'upgrade a Enterprise Plus, inserisci il tuo ID istanza e fai clic su Esegui l'upgrade della versione.

In alternativa, puoi anche eseguire l'upgrade di un'istanza facendo clic su Esegui l'upgrade nella Sezione Configurazione della pagina Panoramica dell'istanza.

gcloud

L'esempio di codice seguente mostra come eseguire l'upgrade dell'istanza alla versione Cloud SQL Enterprise Plus:


gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise-plus \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto dell'istanza di cui vuoi eseguire l'upgrade.
  • INSTANCE_ID: nome dell'istanza di cui vuoi eseguire l'upgrade.
  • MACHINE_TYPE: il tipo di macchina dell'istanza di cui vuoi eseguire l'upgrade. Per saperne di più sui tipi di macchina per la versione Cloud SQL Enterprise Plus, vedi Tipi di macchina per le istanze della versione Cloud SQL Enterprise Plus.

REST

Il comando seguente esegue l'upgrade dell'istanza alla versione Cloud SQL Enterprise e attiva un'operazione di riavvio.

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

  • PROJECT_ID: l'ID progetto dell'istanza di cui vuoi eseguire l'upgrade.
  • INSTANCE_ID: l'ID istanza dell'istanza di cui vuoi eseguire l'upgrade.
  • MACHINE_TYPE: il tipo di macchina dell'istanza di cui vuoi eseguire l'upgrade. Per saperne di più sui tipi di macchina per la versione Cloud SQL Enterprise Plus, vedi Tipi di macchina per le istanze della versione Cloud SQL Enterprise Plus.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Il comando seguente esegue l'upgrade dell'istanza alla versione Cloud SQL Enterprise e attiva un'operazione di riavvio.

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

  • PROJECT_ID: l'ID progetto dell'istanza di cui vuoi eseguire l'upgrade.
  • INSTANCE_ID: l'ID istanza dell'istanza di cui vuoi eseguire l'upgrade.
  • MACHINE_TYPE: il tipo di macchina dell'istanza di cui vuoi eseguire l'upgrade. Per saperne di più sui tipi di macchina per la versione Cloud SQL Enterprise Plus, vedi Tipi di macchina per le istanze della versione Cloud SQL Enterprise Plus.

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Percorso di archiviazione dei log delle transazioni utilizzati per il PITR

Se l'istanza della versione Cloud SQL Enterprise archivia i log delle transazioni per PITR disco, quindi avvia il processo di upgrade La versione Cloud SQL Enterprise Plus cambia la posizione di archiviazione di questi log in Cloud Storage.

La procedura di cambio di posizione si applica alle seguenti condizioni:

  • La procedura dura approssimativamente la durata del transactionLogRetentionDays Impostazione di configurazione PITR per completare il passaggio a Cloud Storage.
  • Se hai impostato dei valori per expire_logs_days o binlog_expire_logs_seconds sulla tua istanza, vengono conservati.
  • Durante il passaggio a Cloud Storage, non puoi modificare i valori per expire_logs_days o binlog_expire_logs_seconds sulla tua istanza.
  • Durante il passaggio a Cloud Storage, ti consigliamo di non modifichi l'impostazione di configurazione PITR transactionLogRetentionDays. Anche se aumenti transactionLogRetentionDays, log binari non verranno conservati su disco per un periodo superiore a quello per impostazione predefinita è di 7 giorni per un'istanza della versione Cloud SQL Enterprise.
  • Mentre il pulsante è in corso, Cloud SQL conserva solo su disco per il valore minimo di uno dei seguenti valori:
    • l'impostazione di configurazione PITR transactionLogRetentionDays di prima il passaggio, 7 giorni per impostazione predefinita
    • expire_logs_days o binlog_expire_logs_seconds impostati manualmente sull'istanza
  • Dopo il passaggio, Cloud SQL conserva la stessa quantità log binari su disco che aveva prima del passaggio, a meno che tu non abbia impostato expire_logs_days oppure binlog_expire_logs_seconds sulla tua istanza. Se hai impostato questi flag, Cloud SQL conserva i file binari log su disco in base al valore minimo dell'impostazione di configurazione transactionLogRetentionDays o al valore dei flag.

Impostazioni predefinite per il backup e l'archiviazione dei log della versione Cloud SQL Enterprise Plus

Una volta completato il passaggio a Cloud Storage per un'istanza, Cloud SQL conserva comunque copie log binari su disco per scopi di replica. L'archiviazione di log binari su disco può essere utile se vuoi sfogliare i log binari con l'utilità mysqlbinlog.

Se hai configurato expire_logs_days e binlog_expire_logs_seconds di flag sulla tua istanza prima dell'upgrade, i valori configurati rimarranno invariati.

Dopo il cambio, poiché i log binari utilizzati per eseguire il PITR sono ora archiviati in Cloud Storage, assicurati che i valori dei flag riflette la conservazione dei log delle transazioni sul disco prevista. Cloud SQL conserva solo su disco per il valore minimo di uno dei seguenti valori:

  • l'impostazione di configurazione PITR transactionLogRetentionDays prima del passaggio, 7 giorni per impostazione predefinita
  • expire_logs_days o binlog_expire_logs_seconds impostati manualmente sull'istanza

Se vuoi risparmiare spazio su disco, al termine dell'upgrade configura il valore di expire_logs_days o binlog_expire_logs_seconds equivale a 1 giorno, in modo da ridurre le dimensioni del disco allocato e il disco i costi di archiviazione. Per ulteriori informazioni sull'archiviazione dei log delle transazioni e sul PITR, consulta Archiviazione dei log per PITR.

Al termine dell'upgrade alla versione Cloud SQL Enterprise Plus, verrà visualizzato il log delle transazioni predefinito per tutte le istanze di cui è stato periodo di conservazione l'upgrade viene portato a 14 giorni. Per questo aumento e qualsiasi altro aumento per cui configuri il periodo di conservazione dei log delle transazioni, nuovi e aumentati di valore per raggiungere l'intera finestra di fidelizzazione del PITR. Ad esempio, se il valore precedente dei giorni di conservazione dei log delle transazioni è 7 e il nuovo valore viene aumentato a 14, la finestra per PITR per i primi 7 giorni dopo l'upgrade è di soli 7 giorni. L'8° giorno, la finestra per il PITR diventa 8 giorni, il 9° giorno diventa 9 giorni, fino a quando il periodo di conservazione non viene aumentato a 14 giorni su 14° giorno.

Inoltre, il numero predefinito di backup automatici è aumentato da 8 a 15.

Se esegui l'upgrade alla versione Cloud SQL Enterprise Plus dopo aver eseguito un upgrade della versione principale, non potrai eseguire il PITR in un momento specifico che si verifica prima dell'upgrade della versione principale. Questa limitazione si applica anche se il periodo di conservazione copre tale periodo di tempo. Puoi ripristinare l'istanza in un point-in-time dopo l'avvio l'upgrade della versione principale.

Passa alla versione Cloud SQL Enterprise

Console

  1. Nella console Google Cloud, vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Fai clic su Modifica.
  4. Nella sezione Scegli una versione di Cloud SQL, fai clic su Passa a Enterprise.
  5. Nel riquadro Passa a Enterprise, inserisci l'ID istanza e fai clic su Cambia versione.

In alternativa, puoi passare alla versione Cloud SQL Enterprise facendo clic su Passa a Enterprise nella sezione Configurazione. della pagina Panoramica dell'istanza.

gcloud

L'esempio di codice seguente mostra come cambiare l'istanza per passare alla versione Cloud SQL Enterprise:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID
Sostituisci quanto segue:

REST

Il comando seguente modifica l'istanza nella versione Cloud SQL Enterprise e attiva un'operazione di riavvio.

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

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

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": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Il comando seguente modifica l'istanza nella versione Cloud SQL Enterprise e attiva un'operazione di riavvio.

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

Metodo HTTP e URL: 

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

Corpo JSON della richiesta: 

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

Per inviare la richiesta, espandi una delle seguenti opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Impostazioni predefinite per il backup e l'archiviazione dei log della versione Cloud SQL Enterprise

Il passaggio alla versione Cloud SQL Enterprise non cambia la località di archiviazione dei log delle transazioni usati per il PITR. Se l'istanza della versione Cloud SQL Enterprise Plus archivia i propri log delle transazioni per PITR in Cloud Storage, quindi i log rimangono di archiviazione ideale in Cloud Storage. Tuttavia, invece di archiviare 14 giorni di log delle transazioni Per impostazione predefinita, il valore predefinito è 7 giorni. Configurazione backup non viene modificato.

Passaggi successivi