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


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 ulteriori informazioni, consulta la 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 e il tempo di riposo è quasi nullo. Il passaggio alla versione Cloud SQL Enterprise può richiedere fino a 60 secondi di tempo di inattività.

Inoltre, questa procedura di upgrade non richiede la modifica degli endpoint a cui si connettono le 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 Enterprise Plus di Cloud SQL sono attivate 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 la procedura di upgrade, consulta Posizione di archiviazione dei log delle transazioni utilizzati per la PITR.

Eseguire 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 l'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 a 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.

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 a 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 di queste 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 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 a 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 di queste 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 Cloud SQL Enterprise archivia i log delle transazioni per il PITR su disco, l'avvio della procedura di upgrade alla versione Cloud SQL Enterprise Plus sposta la posizione di archiviazione di questi log su Cloud Storage.

Alla procedura di trasferimento della sede si applicano le seguenti condizioni:

  • Il processo richiede circa la durata dell'impostazione di configurazione PITR di transactionLogRetentionDays per completare il passaggio a Cloud Storage.
  • Se hai impostato valori per il flag expire_logs_days o binlog_expire_logs_seconds nella tua istanza, questi valori vengono mantenuti.
  • Durante il passaggio a Cloud Storage, non puoi modificare i valori per i flag expire_logs_days o binlog_expire_logs_seconds nell'istanza.
  • Durante il passaggio a Cloud Storage, ti consigliamo di non modificare l'impostazione di configurazione PITR di 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 passaggio è in corso, Cloud SQL conserva i log sul disco solo per il valore minimo di uno dei seguenti elementi:
    • l'impostazione di configurazione del recupero point-in-time transactionLogRetentionDays precedente al passaggio, 7 giorni per impostazione predefinita
    • i flag 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 flag expire_logs_days o binlog_expire_logs_seconds sulla tua 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 Enterprise Plus di Cloud SQL

Al termine del passaggio a Cloud Storage per un'istanza, Cloud SQL conserva ancora le copie dei log binari sul disco a scopo di replica. L'archiviazione dei 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 passaggio, poiché i log binari utilizzati per eseguire il PITR ora vengono archiviati in Cloud Storage, assicurati che i valori degli indicatori riflettano la conservazione dei log delle transazioni su disco prevista. Cloud SQL conserva i log su disco solo per il valore minimo di uno dei seguenti elementi:

  • 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, imposta il valore del flag expire_logs_days o binlog_expire_logs_seconds sull'equivalente di 1 giorno per ridurre le dimensioni del disco allocate e i costi di archiviazione su disco. Per ulteriori informazioni sull'archiviazione dei log delle transazioni e sul PITR, consulta Archiviazione dei log per il PITR.

Al termine dell'upgrade alla versione Cloud SQL Enterprise Plus, il periodo di conservazione dei log delle transazioni predefinito per tutte le istanze di cui è stato eseguito l'upgrade viene aumentato a 14 giorni. Per questo aumento e per qualsiasi altro aumento configurato per il periodo di conservazione dei log delle transazioni, è necessario il nuovo valore aumentato per raggiungere la finestra di conservazione completa 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. All'ottavo giorno, la finestra per il PITR diventa di 8 giorni, al nono giorno diventa di 9 giorni, fino a quando la finestra di conservazione non viene finalmente aumentata a 14 giorni al giorno 14.

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 recupero point-in-time a un punto in tempo precedente 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 successivo all'avvio dell'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 seguente comando modifica l'istanza in 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 di queste 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 seguente comando modifica l'istanza in 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 di queste 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, anziché archiviare per impostazione predefinita 14 giorni di log delle transazioni per il PITR, il valore predefinito è stato modificato in 7 giorni. La configurazione del backup non viene modificata.

Passaggi successivi