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 un'istanza dalla versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus. Descrive inoltre la procedura per eseguire il downgrade di un'istanza della 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 PostgreSQL.

Per abilitare questi miglioramenti per le istanze esistenti della versione Cloud SQL Enterprise, devi eseguirne l'upgrade alla versione Cloud SQL Enterprise Plus. Il completamento del processo di upgrade richiede alcuni minuti, con un tempo di inattività previsto di meno di 60 secondi. Inoltre, questo processo non richiede alle applicazioni di modificare gli endpoint a cui si connettono.

Prima di iniziare

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

    Se l'istanza si trova su una versione precedente di PostgreSQL, devi eseguire l'upgrade dell'istanza a PostgreSQL 12 o versioni successive. Per maggiori informazioni, consulta Eseguire l'upgrade della versione principale del database in loco.

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

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

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

(Facoltativo) Puoi attivare la cache di 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 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.

(Facoltativo) Puoi attivare la cache di 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 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"
}

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

Passaggi successivi