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 la Introduzione alle versioni di Cloud SQL per PostgreSQL.

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

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

  Se la tua istanza utilizza una versione precedente di PostgreSQL, devi eseguire l'upgrade 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 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 write-ahead utilizzati per il PITR su disco, la procedura di upgrade alla versione Cloud SQL Enterprise Plus sposta la posizione di archiviazione dei log write-ahead 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 per i log di scrittura anticipata 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.

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

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.
• Durante il passaggio a Cloud Storage, ti consigliamo di non modificare l'impostazione di configurazione PITR di transactionLogRetentionDays. Anche se aumenti transactionLogRetentionDays, i log di scrittura anticipata non verranno conservati su disco per più del valore predefinito di 7 giorni per un'istanza Cloud SQL Enterprise.

Valori predefiniti per lo spazio di archiviazione dei backup e dei log della versione Enterprise Plus di Cloud SQL

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

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

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

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE"
  }
}

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

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

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

• Scopri di più sulla versione Cloud SQL Enterprise Plus.