Upgrade in loco

Questa pagina descrive come eseguire upgrade e downgrade in loco delle istanze Cloud SQL.

Apportare modifiche in loco a un'istanza Cloud SQL

Puoi utilizzare le modifiche in loco per eseguire l'upgrade o il downgrade della versione, del tipo di macchina, del tipo di archiviazione o della versione del database dell'istanza Cloud SQL. Apportare modifiche in loco è il modo più semplice e meno soggetto a errori per riconfigurare un'istanza.

Prima di iniziare

Assicurati che l'istanza sia in esecuzione su PostgreSQL 12 o versioni successive.

Se l'istanza utilizza una versione precedente di PostgreSQL, devi eseguire l'upgrade a PostgreSQL 12 o versioni successive. Per saperne di più, consulta Eseguire l'upgrade in loco della versione principale del database.

Tieni presente le potenziali modifiche all'archiviazione correlate al tipo di macchina

Le diverse versioni supportano tipi di macchine diversi che utilizzano opzioni di archiviazione diverse. I tipi di macchine C4 e C4A ad alte prestazioni utilizzano l'archiviazione Hyperdisk bilanciato anziché una delle opzioni di disco permanente utilizzate dai tipi di macchine precedenti.

Quando modifichi la versione o il tipo di macchina che stai utilizzando, anche il tipo di archiviazione potrebbe cambiare, il che potrebbe comportare un periodo di inattività e una modifica dei costi di archiviazione. Quando passi a Google Cloud Hyperdisk bilanciato, puoi specificare opzioni di configurazione aggiuntive. Per saperne di più, consulta Modifiche all'archiviazione.

Tieni presente le modifiche all'archiviazione dei log delle transazioni PITR

Se esegui l'upgrade di un'istanza della versione Cloud SQL Enterprise che archivia i log write-ahead utilizzati per PITR su disco, tieni presente che la procedura di upgrade alla versione Cloud SQL Enterprise Plus sposta la località di archiviazione di questi log dal disco a Cloud Storage. Per determinare la località attuale dei log write-ahead PITR per la tua istanza, consulta Controllare la località di archiviazione dei log delle transazioni utilizzati per PITR.

Per una spiegazione completa di come gli upgrade in loco possono influire sulla località dei log write-ahead, consulta Modifiche alla località di archiviazione dei log write-ahead per PITR.

Modificare la versione di un'istanza in loco

Questa sezione mostra come modificare la versione dell'istanza Cloud SQL in loco da o verso la versione Cloud SQL Enterprise Plus. La versione Cloud SQL Enterprise Plus offre alcuni vantaggi e miglioramenti delle prestazioni che la versione Cloud SQL Enterprise non offre. Per saperne di più sulle versioni di Cloud SQL, consulta Panoramica delle versioni di Cloud SQL.

L'upgrade alla versione Cloud SQL Enterprise Plus richiede alcuni minuti per essere completato e comporta un periodo di inattività quasi nullo. Il passaggio alla versione Cloud SQL Enterprise comporta un periodo di inattività più lungo. Nessuna delle due procedure richiede la modifica degli endpoint a cui si connettono le applicazioni.

Utilizza la procedura descritta in questa sezione per eseguire l'upgrade di un'istanza della versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus o per eseguire il downgrade di un'istanza della versione Cloud SQL Enterprise Plus alla versione Cloud SQL Enterprise.

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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"

$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

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

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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"

$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

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

Opzioni per le modifiche in loco

La modifica della versione dell'istanza Cloud SQL può richiedere la modifica della serie di macchine, che a sua volta influisce sul tipo di archiviazione.

Modifiche alla macchina

Quando modifichi le versioni, devi modificare anche il tipo di macchina. Per saperne di più sulle serie di macchine supportate da Cloud SQL, consulta Scegliere una serie di macchine.

Quando esegui l'upgrade dalla versione Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus, puoi scegliere tra le serie di macchine N2, C4A e C4.

Quando esegui il downgrade dalla versione Cloud SQL Enterprise Plus alla versione Cloud SQL Enterprise, puoi scegliere tra una serie di macchine con core dedicato per uso generico, e una serie di macchine N4.

Puoi anche modificare il tipo di macchina senza modificare la versione. Dopo aver scelto di modificare l'istanza, vai alla sottosezione Macchina di Configurazione macchina nell'area Personalizza l'istanza. Utilizzando il menu a discesa, puoi selezionare un tipo di macchina diverso. Puoi anche scegliere un numero diverso di vCPU e abilitare o disabilitare la cache dei dati, se necessario.

Per informazioni più generali, consulta anche la documentazione di Compute Engine per le N2, C4A, C4 e N4.

Modifiche all'archiviazione

Se passi da una serie di macchine per uso generico o N2 a una serie di macchine N4, C4A o C4, l'archiviazione verrà migrata da unità a stato solido (SSD) a Google Cloud Hyperdisk bilanciato storage. In genere, questo upgrade richiede un periodo di inattività minimo.

L'archiviazione Google Cloud Hyperdisk bilanciato può essere personalizzata per il tuo caso d'uso impostando quanto segue:

• Capacità dello spazio di archiviazione
• IOPS sottoposte a provisioning
• Throughput riservato

Google Cloud Hyperdisk bilanciato imposta i valori e i limiti predefiniti di IOPS e throughput in base alla configurazione dell'istanza, che include il tipo di macchina e la capacità di archiviazione. La capacità di archiviazione limita il valore predefinito, mentre il tipo di macchina imposta il valore massimo sia per le IOPS sia per il throughput. Per maggiori dettagli, consulta Scegliere un'opzione di archiviazione.

Modifiche alla località dei log write-ahead per PITR

Se l'istanza della versione Cloud SQL Enterprise archivia i log delle transazioni per PITR su disco, l'avvio della procedura di upgrade alla versione Cloud SQL Enterprise Plus sposta la località di archiviazione di questi log in Cloud Storage.

Le seguenti condizioni si applicano alla modifica della località:

• La procedura richiede circa la durata del transactionLogRetentionDays impostazione di configurazione PITR per completare il passaggio a Cloud Storage.
• Durante il passaggio a Cloud Storage, ti consigliamo di non modificare l'impostazione di configurazione PITR transactionLogRetentionDays. Anche se aumenti transactionLogRetentionDays, i log write-ahead non verranno conservati su disco per più di 7 giorni, che è il valore predefinito per un'istanza della versione Cloud SQL Enterprise.

Valori predefiniti per l'archiviazione di backup e log della versione Cloud SQL Enterprise Plus

Il passaggio alla versione Cloud SQL Enterprise non modifica la località di archiviazione dei log delle transazioni utilizzati per PITR. Se l'istanza della versione Cloud SQL Enterprise Plus archivia i log delle transazioni per PITR in Cloud Storage, i log rimangono in Cloud Storage. Tuttavia, anziché archiviare per impostazione predefinita 14 giorni di log delle transazioni per PITR, il valore predefinito viene modificato in 7 giorni. La configurazione del backup non viene modificata.