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 saperne di più, consulta Introduzione alle versioni di Cloud SQL per PostgreSQL.

Per abilitare questi miglioramenti per le istanze esistenti della versione Cloud SQL Enterprise, devi eseguire l'upgrade a 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

  • Assicurati di eseguire un'istanza della versione Cloud SQL Enterprise su PostgreSQL 12 o versioni successive.

    Se l'istanza utilizza una versione precedente di PostgreSQL, devi eseguire l'upgrade dell'istanza a PostgreSQL 12 o versioni successive. Per ulteriori informazioni, consulta Eseguire l'upgrade in situ della versione principale del database.

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 write-ahead utilizzati per PITR su disco, quindi il processo di upgrade alla versione Cloud SQL Enterprise Plus cambia la posizione di archiviazione i log write-ahead dal 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 per i log di scrittura anticipata utilizzati per il PITR. Per ulteriori informazioni e istruzioni su come controllare l'istanza, vedi Controlla la posizione di archiviazione dei log delle transazioni utilizzati per il 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 l'ID istanza e poi 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

(Facoltativo) Puoi anche abilitare la cache di dati per l'istanza aggiungendo il flag --enable-data-cache.

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 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 macchina per la versione Cloud SQL Enterprise Plus, vedi Tipi di macchina per le istanze della versione Cloud SQL Enterprise Plus.

(Facoltativo) Puoi attivare la cache dei dati impostando il parametro dataCacheEnabled su true.

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 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 a 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.

(Facoltativo) Puoi attivare la cache dei dati impostando il parametro dataCacheEnabled su true.

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"
}

Percorso di archiviazione dei log delle transazioni utilizzati per il 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.
  • Durante il passaggio a Cloud Storage, ti consigliamo di non modificare l'impostazione di configurazione PITR di transactionLogRetentionDays. Anche se aumenti transactionLogRetentionDays, i log write-ahead 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.

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

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 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. 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

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 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, 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 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"
}

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

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. Configurazione backup non viene modificato.

Passaggi successivi