Questa pagina è stata tradotta dall'API Cloud Translation.

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

MySQL | PostgreSQL | SQL Server

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 ulteriori informazioni, consulta la Introduzione alle versioni di Cloud SQL per SQL Server.

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

Inoltre, questa procedura di upgrade non richiede la modifica degli endpoint a cui si connettono le tue applicazioni.

Prima di iniziare

Assicurati di eseguire un'istanza Cloud SQL Enterprise su SQL Server Enterprise 2019 o SQL Server Enterprise 2022.

Nota: se imposti il flag max server memory (mb), ti consigliamo di rimuoverlo dopo aver eseguito l'upgrade dell'istanza alla versione Cloud SQL Enterprise Plus. In questo modo, Cloud SQL può gestire automaticamente il valore del flag. Tuttavia, se preferisci impostare il valore, puoi rivedere il valore del flag dopo l'upgrade dell'istanza e modificarlo in base alle dimensioni della VM.
Assicurati che il progetto della rete sia stato creato dopo agosto 2021 o che sia stato eseguito l'upgrade completo alla nuova architettura di rete.

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.

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 l'ID istanza e 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

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 a cui vuoi eseguire l'upgrade. Per saperne di più sui tipi di macchine per la versione Cloud SQL Enterprise Plus, consulta Tipi di macchine per le istanze della versione Cloud SQL Enterprise Plus.

REST

Il seguente comando 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 macchine per la versione Cloud SQL Enterprise Plus, consulta Tipi di macchine per le istanze della versione Cloud SQL Enterprise Plus.

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 seguente comando 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 gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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)

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso alla CLI gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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 seguente comando 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 macchine per la versione Cloud SQL Enterprise Plus, consulta Tipi di macchine per le istanze della versione Cloud SQL Enterprise Plus.

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, quindi esegui il comando seguente:

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, quindi esegui il comando seguente:

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

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

Il seguente esempio di codice mostra come modificare l'istanza in 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: il nome dell'istanza.
MACHINE_TYPE: il tipo di macchina dell'istanza a cui vuoi passare. Per saperne di più sui tipi di macchine per la versione Enterprise di Cloud SQL, consulta Tipi di macchine per le istanze della versione Enterprise di Cloud SQL.

REST

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

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, quindi esegui il comando seguente:

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, quindi esegui il comando seguente:

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

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, quindi esegui il comando seguente:

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, quindi esegui il comando seguente:

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

Genera automaticamente l'endpoint di scrittura

Un endpoint di scrittura è un nome DNS (Domain Name Service) globale che si risolve automaticamente nell'indirizzo IP dell'istanza Cloud SQL principale corrente. Questo endpoint reindirizza automaticamente le connessioni in arrivo alla nuova istanza principale in caso di operazione di failover della replica. Puoi utilizzare l'endpoint di scrittura in una stringa di connessione SQL anziché in un indirizzo IP. Utilizzando un endpoint di scrittura, puoi evitare di dover apportare modifiche alla connessione dell'applicazione in caso di interruzione del servizio a livello di regione.

Se esegui l'upgrade dell'istanza con un indirizzo IP privato sulla nuova architettura di rete alla versione Cloud SQL Enterprise Plus e attivi l'API DNS per il tuo progetto Google Cloud, Cloud SQL genera automaticamente l'endpoint di scrittura. Tuttavia, al certificato del server associato all'istanza non verrà aggiunto l'endpoint di scrittura (nome DNS globale). Pertanto, se vuoi verificare il nome DNS, devi ruotare il certificato. Al termine della rotazione di questo certificato, Cloud SQL aggiunge il nome DNS al certificato. Puoi utilizzare il nome DNS per la verifica dell'identità del server.

Passaggi successivi

Scopri di più sulla versione Cloud SQL Enterprise Plus.