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 situ per eseguire l'upgrade di un'istanza Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus. Inoltre, descrive anche la procedura per eseguire il passaggio da un'istanza 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 attivare questi miglioramenti per le istanze Cloud SQL Enterprise esistenti, devi eseguire l'upgrade alla versione Cloud SQL Enterprise Plus. Il processo di upgrade richiede alcuni minuti ha tempi di inattività prossimi allo zero. Il passaggio alla versione Cloud SQL Enterprise può richiedere fino a 60 secondi di inattività.

Inoltre, questo processo di upgrade non richiede di modificare gli endpoint a cui si connettono le tue applicazioni.

Prima di iniziare

Controlla la posizione di archiviazione dei log delle transazioni utilizzati per la copia incrementale in tempo reale

Tutte le istanze della versione Cloud SQL Enterprise Plus sono abilitate automaticamente con il recupero point-in-time (PITR). Se l'istanza Cloud SQL Enterprise di cui vuoi eseguire l'upgrade memorizza i log binari utilizzati per il PITR su disco, la procedura di upgrade alla versione Cloud SQL Enterprise Plus cambia la posizione di archiviazione dei log binari da disco a Cloud Storage.

Prima di eseguire l'upgrade alla versione Cloud SQL Enterprise Plus, controlla se l'istanza Cloud SQL Enterprise subirà il trasferimento della posizione di archiviazione dei log binari utilizzati per il PITR. Per ulteriori informazioni e istruzioni su come controllare l'istanza, consulta Verificare la posizione di archiviazione dei log delle transazioni utilizzati per la 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 eseguire l'upgrade di un'istanza anche facendo clic su Esegui upgrade nella sezione Configurazione della pagina Panoramica dell'istanza.

gcloud

Il seguente esempio di codice 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: il 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 seguente comando esegue l'upgrade dell'istanza alla versione Cloud SQL Enterprise e attiva un'operazione di riavvio.

Prima di utilizzare i dati della richiesta, apporta 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 macchine per la versione Cloud SQL Enterprise Plus, consulta Tipi di macchine 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, apporta 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 macchine per la versione Cloud SQL Enterprise Plus, consulta Tipi di macchine 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"
}

Posizione di archiviazione dei log delle transazioni utilizzati per la 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.

Alla procedura di trasferimento della sede si applicano le 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, i log binari non verranno conservati sul disco per più del valore predefinito di 7 giorni per un'istanza 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à di log binari sul disco che avevi prima del passaggio a meno che non tu abbia impostato i expire_logs_days o binlog_expire_logs_seconds flag sull'istanza. Se hai impostato questi flag, Cloud SQL conserva i log binari su disco in base al valore minimo dell'impostazione di configurazione transactionLogRetentionDays o al valore dei flag.

Valori predefiniti per lo spazio di archiviazione dei backup e 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 a scopo 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 i flag expire_logs_days e binlog_expire_logs_seconds nell'istanza prima dell'upgrade, i valori configurati rimangono 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 transactionLogRetentionDays PITR prima del passaggio, 7 giorni per impostazione predefinita
  • i flag 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 equivalente 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 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 vecchio valore per i giorni di conservazione dei log delle transazioni è 7 e il nuovo valore viene aumentato a 14, la finestra per la conservazione a livello di istanza 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 fino a un point-in-time che si verifica prima all'upgrade della versione principale. Questa limitazione si applica anche se il periodo di conservazione copre questo periodo di tempo. Puoi ripristinare l'istanza a un punto nel tempo dopo aver avviato l'upgrade della versione principale.

Passare 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 anche passare alla versione Cloud SQL Enterprise facendo clic su Passa a Enterprise nella sezione Configurazione della pagina Panoramica dell'istanza.

gcloud

Il seguente esempio di codice mostra come modificare l'istanza in 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, apporta 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, apporta 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"
}

Valori predefiniti per lo spazio di archiviazione dei log e dei backup della versione Enterprise di Cloud SQL

Il passaggio alla versione Enterprise di Cloud SQL non modifica la posizione di archiviazione degli log delle transazioni utilizzati per il PITR. Se l'istanza Cloud SQL Enterprise Plus immagazzina i log delle transazioni per il ripristino dei dati dopo un'interruzione in Cloud Storage, i log rimangono 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