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

MySQL | PostgreSQL | SQL Server

Questa pagina mostra come utilizzare il metodo di upgrade in loco per eseguire l'upgrade di un'istanza della versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus. Viene inoltre descritta la procedura per eseguire il downgrade di un'istanza dell'edizione 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 Cloud SQL per PostgreSQL.

Per abilitare questi miglioramenti per le istanze della versione Enterprise di Cloud SQL esistenti, devi eseguirne l'upgrade alla versione Cloud SQL Enterprise Plus. Il processo di upgrade richiede alcuni minuti, con un tempo di inattività previsto inferiore a 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 utilizza 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 descritta in questa sezione per eseguire l'upgrade di un'istanza della versione Cloud SQL Enterprise a Cloud SQL Enterprise Plus.

Console

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
Nella sezione Scegli una versione di Cloud SQL, fai clic su Esegui l'upgrade.
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

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 attivare la cache dei 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, consulta Tipi di macchine 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, consulta Tipi di macchine 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:

curl (Linux, macOS o Cloud Shell)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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, consulta Tipi di macchine 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:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

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

Vai a Istanze Cloud SQL
Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
Fai clic su Modifica.
Nella sezione Scegli una versione di Cloud SQL, fai clic su Passa a Enterprise.
Nel riquadro Passa a Enterprise, inserisci il tuo 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 cambiare l'istanza nella versione Cloud SQL Enterprise:

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

Sostituisci quanto segue:

PROJECT_ID: l'ID progetto dell'istanza.
INSTANCE_ID: nome dell'istanza.
MACHINE_TYPE: il tipo di macchina dell'istanza a cui vuoi passare. Per saperne di più sui tipi di macchina per la versione Cloud SQL Enterprise, consulta Tipi di macchine per le istanze della versione Cloud SQL Enterprise.

REST

Il comando seguente modifica la tua istanza nella 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.
INSTANCE_ID: l'ID dell'istanza.
MACHINE_TYPE: il tipo di macchina dell'istanza a cui vuoi passare. Per saperne di più sui tipi di macchina per la versione Cloud SQL Enterprise, consulta Tipi di macchine per le istanze della versione Cloud SQL Enterprise.

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:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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 la tua istanza nella 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.
INSTANCE_ID: l'ID dell'istanza.
MACHINE_TYPE: il tipo di macchina dell'istanza a cui vuoi passare. Per saperne di più sui tipi di macchina per la versione Cloud SQL Enterprise, consulta Tipi di macchine per le istanze della versione Cloud SQL Enterprise.

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:

curl (Linux, macOS o Cloud Shell)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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

Scopri di più sulla versione Cloud SQL Enterprise Plus.