Esegui l'upgrade della versione principale del database in loco

Questa pagina descrive come eseguire l'upgrade della versione principale del database eseguendo l'upgrade dell'istanza Cloud SQL in loco anziché eseguendo la migrazione dei dati.

Introduzione

I fornitori di software per database rilasciano periodicamente nuove versioni principali che contengono nuove funzionalità, miglioramenti delle prestazioni e della sicurezza. Cloud SQL adotta le nuove versioni dopo il loro rilascio. Dopo che Cloud SQL offre il supporto per una nuova versione principale, puoi eseguire l'upgrade delle istanze per mantenere aggiornato il database.

Puoi eseguire l'upgrade della versione del database di un'istanza in loco o eseguendo la migrazione dei dati. Gli upgrade in loco sono un modo più semplice per eseguire l'upgrade della versione principale dell'istanza. Non è necessario eseguire la migrazione dei dati o modificare le stringhe di connessione dell'applicazione. Con gli upgrade in loco, puoi mantenere il nome, l'indirizzo IP e altre impostazioni dell'istanza corrente dopo l'upgrade. Gli upgrade in loco non richiedono lo spostamento dei file di dati e possono essere completati più rapidamente. In alcuni casi, il tempo di inattività è inferiore a quello richiesto dalla migrazione dei dati.

L'operazione di upgrade sul posto di Cloud SQL per SQL Server utilizza l'utilità di upgrade sul posto di SQL Server.

Pianifica un upgrade della versione principale

  1. Verifica di disporre del ruolo richiesto per eseguire un upgrade della versione principale: Cloud SQL Owner o Cloud SQL Admin.

  2. Scegli una versione principale di destinazione.

    gcloud

    Per informazioni sull'installazione e su come iniziare a utilizzare gcloud CLI, consulta Installa gcloud CLI. Per informazioni sull'avvio di Cloud Shell, consulta Utilizza Cloud Shell.

    Per controllare le versioni del database che puoi scegliere come target per un upgrade in loco sulla tua istanza, segui questi passaggi:

    1. Esegui questo comando.
      2. gcloud sql instances describe INSTANCE_NAME

      Sostituisci INSTANCE_NAME con il nome dell'istanza.

    2. Nell'output del comando, individua la sezione con l'etichetta upgradableDatabaseVersions.
    3. Ogni sottosezione restituisce una versione del database disponibile per l'upgrade. In ogni sottosezione, esamina i seguenti campi.
      • majorVersion: la versione principale che puoi scegliere come target per l'upgrade in loco.
      • name: la stringa della versione del database che include la versione principale.
      • displayName: il nome visualizzato della versione del database.

    REST v1

    Per verificare quali versioni del database di destinazione sono disponibili per un upgrade sul posto della versione principale, utilizza il metodo instances.get dell'API Cloud SQL Admin.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • INSTANCE_NAME: il nome dell'istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    
upgradableDatabaseVersions:

{
  major_version: "SQLSERVER_2025_STANDARD"
  name: "SQLSERVER_2025_STANDARD"
  display_name: "SQL Server 2025 Standard"
}

    REST v1beta4

    Per verificare quali versioni del database di destinazione sono disponibili per l'upgrade della versione principale di un'istanza, utilizza il metodo instances.get dell'API Cloud SQL Admin.

    Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:

    • INSTANCE_NAME: il nome dell'istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    
upgradableDatabaseVersions:

{
  major_version: "SQLSERVER_2025_STANDARD"
  name: "SQLSERVER_2025_STANDARD"
  display_name: "SQL Server 2025 Standard"
}

    Per l'elenco completo delle versioni del database supportate da Cloud SQL, consulta Versioni del database e policy per le versioni.

  3. Considera le funzionalità offerte in ogni versione principale del database e risolvi le incompatibilità.

    Consulta le funzionalità non più disponibili e le modifiche che provocano un errore di SQL Server.

    Le nuove versioni principali introducono modifiche incompatibili che potrebbero richiedere la modifica del codice dell'applicazione, dello schema o delle impostazioni del database. Prima di poter eseguire l'upgrade dell'istanza del database, consulta le note di rilascio della versione principale di destinazione per determinare le incompatibilità che devi risolvere.

  4. Testa l'upgrade con un dry run.

    Esegui un dry run della procedura di upgrade end-to-end in un ambiente di test prima di eseguire l'upgrade del database di produzione. Puoi clonare l'istanza per creare una copia identica dei dati su cui testare il processo di upgrade.

    Oltre a verificare che l'upgrade venga completato correttamente, esegui dei test per assicurarti che l'applicazione si comporti come previsto sul database di cui è stato eseguito l'upgrade.

  5. Decidi quando eseguire l'upgrade.

    L'upgrade richiede che l'istanza non sia disponibile per un periodo di tempo. Pianifica l'upgrade in un periodo di tempo in cui l'attività del database è ridotta.

Esegui l'upgrade della versione principale

Puoi eseguire l'upgrade della versione principale di una singola istanza Cloud SQL oppure puoi eseguire l'upgrade della versione principale di un'istanza principale e includere nell'upgrade tutte le sue repliche, incluse le repliche in cascata e tra regioni.

Esegui l'upgrade della versione principale di una singola istanza

Quando avvii un'operazione di upgrade per una singola istanza, Cloud SQL esegue le seguenti operazioni:

  1. Controlla la configurazione dell'istanza per assicurarsi che sia compatibile con un upgrade.
  2. Dopo che Cloud SQL ha verificato la configurazione, l'istanza non è più disponibile.
  3. Esegue un backup pre-upgrade.
  4. Esegue l'upgrade dell'istanza.
  5. Rende disponibile l'istanza.
  6. Esegue un backup post-upgrade.

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 Informazioni sull'istanza, fai clic sul pulsante Esegui l'upgrade e conferma che vuoi andare alla pagina di upgrade.
  5. Nella pagina Scegli una versione del database, fai clic sull'elenco Versione del database per l'upgrade e seleziona una delle versioni principali del database disponibili.
  6. Fai clic su Continua.
  7. Nella casella ID istanza, inserisci il nome dell'istanza e fai clic sul pulsante Avvia l'upgrade.
Il completamento dell'operazione richiede diversi minuti.

Verifica che la versione principale del database di cui è stato eseguito l'upgrade venga visualizzata sotto il nome dell'istanza nella pagina Panoramica dell'istanza.

gcloud

  1. Avvia l'upgrade.

    Utilizza il comando gcloud sql instances patch con il flag --database-version.

    Prima di eseguire il comando, sostituisci quanto segue:

    • INSTANCE_NAME: il nome dell'istanza.
    • DATABASE_VERSION: l'enum per la versione principale del database, che deve essere successiva alla versione attuale. Specifica una versione del database per una versione principale disponibile come target di upgrade per l'istanza. Puoi ottenere questo enum come primo passaggio della Pianificazione dell'upgrade. Se hai bisogno di un elenco completo degli enum delle versioni del database, consulta SqlDatabaseEnums.
    gcloud sql instances patch INSTANCE_NAME \
--database-version=DATABASE_VERSION

    Il completamento degli upgrade della versione principale richiede alcuni minuti. Potresti visualizzare un messaggio che indica che l'operazione sta richiedendo più tempo del previsto. Puoi ignorare questo messaggio o eseguire il comando gcloud sql operations wait per ignorarlo.

  2. Recupera il nome dell'operazione di upgrade.

    Utilizza il comando gcloud sql operations list con il flag --instance.

    Prima di eseguire il comando, sostituisci quanto segue: * INSTANCE_NAME: il nome dell'istanza. 

    gcloud sql operations list --instance=INSTANCE_NAME

  3. Monitora lo stato dell'upgrade.

    Utilizza il comando gcloud sql operations describe.

    Prima di eseguire il comando, sostituisci la variabile OPERATION con il nome dell'operazione di upgrade recuperato nel passaggio precedente. 

    gcloud sql operations describe OPERATION

REST v1

  1. Avvia l'upgrade in loco.

    Utilizza una richiesta PATCH con il metodo instances:patch.

    Prima di utilizzare i dati della richiesta, sostituisci queste variabili:

    • PROJECT_ID: l'ID del progetto.
    • INSTANCE_NAME: il nome dell'istanza.

    Metodo HTTP e URL: 

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

    Corpo JSON della richiesta: 

    {
  "databaseVersion": DATABASE_VERSION
}

    Sostituisci DATABASE_VERSION con l'enum della versione principale del database, che deve essere successiva alla versione corrente. Specifica una versione del database per una versione principale disponibile come target di upgrade per l'istanza. Puoi ottenere questo enum come primo passaggio della Pianificazione dell'upgrade. Se hai bisogno di un elenco completo degli enum delle versioni del database, consulta SqlDatabaseVersion.

  2. Recupera il nome dell'operazione di upgrade.

    Utilizza una richiesta GET con il metodo operations.list dopo aver sostituito PROJECT_ID con l'ID del progetto.

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations

  3. Monitora lo stato dell'upgrade.

    Utilizza una richiesta GET con il metodo operations.get dopo aver sostituito le seguenti variabili:

    • PROJECT_ID: l'ID del progetto.
    • OPERATION_NAME: il nome dell'operazione di upgrade recuperato nel passaggio precedente.

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operation/OPERATION_NAME

Terraform

Per eseguire l'upgrade della versione principale del database utilizzando Terraform, devi impostare l'argomento database_version nella definizione della risorsa google_sql_database_instance sulla versione principale di destinazione. Devi utilizzare il provider Terraform per Google Cloud versione 4.34.0 o successive.

Gli esempi seguenti mostrano una configurazione google_sql_database_instance di base. Per eseguire l'upgrade della versione principale, imposta l'argomento database_version sulla versione principale pertinente.

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
  }
}

Apporta le seguenti modifiche agli argomenti di Terraform:

  • database_version: imposta questo valore sulla versione principale di destinazione per l'upgrade.
  • deletion_protection: definisce la protezione Terraform a livello di root contro l'eliminazione dell'istanza.
    • true: impedisce a Terraform di eliminare l'istanza. Qualsiasi operazione Terraform che prevede l'eliminazione di questa risorsa è bloccata.
    • false: consente a Terraform di eliminare l'istanza.

Esamina il piano Terraform

Prima di applicare qualsiasi modifica, esegui sempre terraform plan e controlla attentamente l'output. I simboli accanto al nome della risorsa indicano come Terraform applicherà le modifiche:

  • ~ Aggiornamento in loco: questo simbolo indica che Terraform modificherà l'istanza esistente. Questo è il risultato previsto e sicuro per un upgrade della versione principale in loco quando si modifica database_version.
  • +/- Ricrea (sostituzione forzata): questo simbolo indica che Terraform prevede di eliminare l'istanza corrente e crearne una nuova.
    • Se deletion_protection è impostato su true, Terraform genera un errore e blocca questa sostituzione pericolosa. Dovresti impostare esplicitamente deletion_protection = false nella configurazione ed eseguire di nuovo terraform apply per aggiornare lo stato, prima che un successivo apply consenta la distruzione e la ricreazione.
    • Se deletion_protection è impostato su false, terraform apply procederà con la perdita di dati.

    La sostituzione (eliminazione e nuova creazione) delle istanze può essere pianificata a causa di una modifica della configurazione o di un percorso di upgrade non supportato per la modifica in loco. Se trovi un'istanza per cui è pianificata l'eliminazione e la nuova creazione, devi interrompere immediatamente l'operazione e indagare sul motivo della sostituzione pianificata prima che proceda.

Dopo aver esaminato l'output di terraform plan per assicurarti che indichi solo un aggiornamento in loco (~) per la modifica della versione del database, applica la configurazione

Per applicare la configurazione Terraform in un progetto Google Cloud , completa i passaggi descritti nelle sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo principale).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel file main.tf appena creato.

    Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory. 
    terraform init

    Facoltativamente, per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Esamina la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

    Attendi finché Terraform non visualizza il messaggio "Apply complete!".

  3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Quando effettui una richiesta di upgrade sul posto, Cloud SQL esegue prima un controllo pre-upgrade. Se Cloud SQL determina che l'istanza non è pronta per un upgrade, la richiesta di upgrade non va a buon fine e viene visualizzato un messaggio che suggerisce come risolvere il problema. Consulta anche Risolvi i problemi relativi all'upgrade di una versione principale.

Backup degli upgrade automatici

Quando esegui un upgrade della versione principale, Cloud SQL esegue automaticamente due backup on demand, chiamati backup di upgrade:

  • Il primo backup dell'upgrade è il backup pre-upgrade, che viene eseguito immediatamente prima di iniziare l'upgrade. Puoi utilizzare questo backup per ripristinare l'istanza del database allo stato della versione precedente.
  • Il secondo backup di upgrade è il backup post-upgrade, che viene eseguito immediatamente dopo che sono consentite nuove scritture nell'istanza del database di cui è stato eseguito l'upgrade.

Quando visualizzi l'elenco dei backup, i backup di upgrade sono elencati con il tipo On-demand. I backup di upgrade sono etichettati in modo da poterli identificare rapidamente. Ad esempio, se esegui l'upgrade da SQL Server Enterprise 2019 a SQL Server Enterprise 2022 o SQL Server Enterprise 2025, il backup pre-upgrade è etichettato come Pre-upgrade backup, SQLSERVER_2019_ENTERPRISE to SQLSERVER_2022_ENTERPRISE or SQLSERVER_2025_ENTERPRISE. e il backup post-upgrade è etichettato come Post-upgrade backup, SQLSERVER_2022_ENTERPRISE or SQLSERVER_2025_ENTERPRISE from SQLSERVER_2019_ENTERPRISE.

Come per gli altri backup on demand, i backup di upgrade vengono conservati fino a quando non li elimini o non elimini l'istanza.

Esegui l'upgrade del livello di compatibilità del database

Il livello di compatibilità del database determina il comportamento del database rispetto all'applicazione che gestisce. L'impostazione del livello di compatibilità del database garantisce la compatibilità con le versioni precedenti di SQL Server e riguarda le modifiche a Transact-SQL e Query Optimizer. Quando viene eseguito l'upgrade della versione del database di un'istanza SQL Server, i livelli di compatibilità dei database esistenti vengono conservati, in modo che l'applicazione possa continuare a funzionare sulla versione più recente di SQL Server. L'upgrade del livello di compatibilità ti consente di usufruire di nuove funzionalità, miglioramenti dell'elaborazione delle query e altre modifiche.

Dopo aver eseguito l'upgrade della versione del motore del database di un'istanza, quando l'applicazione gestita dal database è pronta, esegui l'upgrade del livello di compatibilità del database per ogni database nell'istanza. Quando il livello di compatibilità è impostato su quello più recente, viene eseguito l'upgrade dei database con le funzionalità più recenti e le prestazioni migliorate.

Per eseguire l'upgrade del livello di compatibilità del database, segui questi passaggi:

  1. Identifica il livello di compatibilità attuale del tuo database.

    Ad esempio, per SQL Server 2017, il livello di compatibilità predefinito è 140. Per verificare il livello di compatibilità attuale del tuo database, esegui questo comando in Transact-SQL, dopo aver sostituito DATABASE_NAME

    con il nome del database nell'istanza SQL Server.

    USE DATABASE_NAME
GO
SELECT compatibility_level
FROM sys.databases WHERE name = 'DATABASE_NAME'

  2. Determina il livello di compatibilità target.

    Identifica la designazione del livello di compatibilità predefinito per la versione del database di cui è stato eseguito l'upgrade per determinare il livello di compatibilità target per il tuo database. Ad esempio, per SQL Server 2025, il livello di compatibilità predefinito è 170. Consulta la tabella che mappa le nuove versioni di SQL Server con i livelli di compatibilità.

  3. Valuta le differenze tra i livelli di compatibilità attuali e quelli di destinazione.

    Prima di eseguire l'upgrade del livello di compatibilità, studia le differenze nel comportamento del sistema tra il livello di compatibilità attuale e quello di destinazione. Consulta l'elenco completo delle differenze tra i livelli di compatibilità.

  4. Raccogli una base di riferimento dei dati del workload.

    Prima di eseguire l'upgrade del livello di compatibilità, raccogli una base di riferimento dei dati del workload utilizzando Query Store di SQL Server, in modo da poter identificare e risolvere in un secondo momento le query regredite. Utilizzi Query Store per acquisire query e piani per un ciclo aziendale tipico per stabilire una base di riferimento per il rendimento. Per un flusso di lavoro guidato, utilizza la funzionalità Query Tuning Assistant in SQL Server Management Studio.

  5. Esegui l'upgrade del livello di compatibilità.

    Per modificare il livello di compatibilità del database, esegui questo comando in Transact-SQL, dopo aver sostituito DATABASE_NAME

    con il nome del database nell'istanza SQL Server e TARGET_COMPATIBILITY_LEVEL con il livello di compatibilità di destinazione.

    ALTER DATABASE DATABASE_NAME
SET COMPATIBILITY_LEVEL = TARGET_COMPATIBILITY_LEVEL;
GO

  6. Raccogli i dati del workload di cui è stato eseguito l'upgrade.

    Raccogli i dati dei workload di cui è stato eseguito l'upgrade utilizzando Query Store per il confronto e il rilevamento delle regressioni.

  7. Risolvi le query con regressione.

    Nella maggior parte dei casi, le modifiche apportate allo Strumento di ottimizzazione delle query nei livelli di compatibilità aggiornati migliorano le prestazioni. Tuttavia, di tanto in tanto, le prestazioni di alcune query potrebbero peggiorare. La funzionalità Query con regressione di Query Store ti aiuta a identificare le query con regressione e ti consente di forzare l'ultimo piano di query valido noto. SQL Server offre anche la correzione automatica del piano, che può passare automaticamente all'ultimo piano valido noto in caso di regressione delle query.

Completa l'upgrade della versione principale

Dopo aver eseguito l'upgrade dell'istanza principale, esegui i test di accettazione per assicurarti che il sistema aggiornato funzioni come previsto.

Risolvi i problemi relativi all'upgrade della versione principale

Cloud SQL restituisce un messaggio di errore se tenti un comando di upgrade non valido, ad esempio se l'istanza contiene flag di database non validi per la nuova versione.

Se la richiesta di upgrade non va a buon fine, controlla la sintassi della richiesta. Se la richiesta ha una struttura valida, prova a esaminare i seguenti suggerimenti.

Visualizza log degli errori

Se si verificano problemi con una richiesta di upgrade valida, Cloud SQL pubblica i log degli errori in projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fsqlserver.err. Ogni voce di log contiene un'etichetta con l'identificatore dell'istanza per aiutarti a identificare l'istanza con l'errore di upgrade. Cerca questi errori di upgrade e risolvili.

Per visualizzare i log degli errori, utilizza la console Google Cloud:

  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. Nel riquadro Operazioni e log della pagina Panoramica dell'istanza, fai clic sul link Visualizza i log degli errori di SQL Server.

    Viene visualizzata la pagina Esplora log.

  4. Visualizza i log nel seguente modo:

    • Per elencare tutti i log degli errori in un progetto, seleziona il nome del log nel filtro Nome log.

    Per saperne di più sui filtri delle query, consulta Query avanzate.

    • Per filtrare i log degli errori di upgrade per una singola istanza, inserisci la seguente query nella casella Cerca in tutti i campi, dopo aver sostituito DATABASE_ID

    con l'ID progetto seguito dal nome dell'istanza in questo formato: project_id:instance_name.

    resource.type="cloudsql_database"
resource.labels.database_id="DATABASE_ID"
logName : "projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fsqlserver.err"

    Ad esempio, per filtrare i log degli errori di upgrade in base a un'istanza denominata shopping-db in esecuzione nel progetto buylots, utilizza il seguente filtro di query:

     resource.type="cloudsql_database"
 resource.labels.database_id="buylots:shopping-db"
 logName : "projects/buylots/logs/cloudsql.googleapis.com%2Fsqlserver.err"

    Puoi esaminare tutti i log segnalati in un determinato periodo di tempo o filtrarli in base alla gravità. Un'opzione comune per la risoluzione dei problemi potrebbe includere la selezione dei seguenti filtri:

    • Emergenza
    • Avviso
    • Critico
    • Errore

Ripristina l'istanza principale alla versione principale precedente

Se il sistema di database di cui è stato eseguito l'upgrade non funziona come previsto, potresti dover ripristinare l'istanza principale alla versione precedente. Per farlo, ripristina il backup pre-upgrade in un'istanza di recupero Cloud SQL, ovvero una nuova istanza che esegue la versione pre-upgrade.

Per ripristinare la versione precedente di un'istanza principale, segui questi passaggi:

  1. Identifica il backup precedente all'upgrade.

    Consulta Backup automatici degli upgrade.

  2. Crea un'istanza di recupero.

    Crea una nuova istanza Cloud SQL utilizzando la versione principale di Cloud SQL in esecuzione al momento della creazione del backup pre-upgrade. Imposta gli stessi flag e le stesse impostazioni dell'istanza utilizzati dall'istanza originale.

  3. Ripristina il backup precedente all'upgrade.

    Ripristina il backup precedente all'upgrade nell'istanza di recupero. L'operazione potrebbe richiedere diversi minuti.

  4. Aggiungi le repliche di lettura.

    Se utilizzi repliche di lettura, aggiungile singolarmente.

  5. Connetti la tua applicazione.

    Dopo aver recuperato il sistema di database, aggiorna l'applicazione con i dettagli dell'istanza di recupero e delle relative repliche di lettura. Puoi riprendere la gestione del traffico sulla versione del database precedente all'upgrade.

Limitazioni

Questa sezione elenca le limitazioni per un upgrade della versione principale in loco.

  • Non puoi eseguire un upgrade della versione principale in loco su una replica esterna.
  • Durante l'upgrade a SQL Server 2025, le istanze con 4 GB di RAM o meno potrebbero diventare lente o non rispondere, causando l'errore dell'operazione. Per evitare questo problema, assicurati che l'istanza abbia almeno 8 GB di RAM prima di eseguire l'upgrade. Al termine dell'upgrade, puoi ridurre le dimensioni dell'istanza.

Domande frequenti

Durante l'upgrade della versione principale del database potrebbero sorgere le seguenti domande.

La mia istanza non è disponibile durante un upgrade?
Sì. L'istanza rimane non disponibile per un periodo di tempo durante il quale Cloud SQL esegue l'upgrade.
Quanto tempo richiede un upgrade?

In genere, l'upgrade di una singola istanza richiede meno di 10 minuti. Se la configurazione dell'istanza ha un numero ridotto di vCPU o di memoria, l'upgrade potrebbe richiedere più tempo.

Se l'istanza ospita troppi database o tabelle o se i database sono molto grandi, l'upgrade potrebbe richiedere ore o addirittura scadere, perché il tempo totale dell'upgrade corrisponde al numero di oggetti nei database. Se devi eseguire l'upgrade di più istanze, il tempo di upgrade aumenta proporzionalmente.

Posso monitorare ogni passaggio del processo di upgrade?
Sebbene Cloud SQL ti consenta di monitorare se un'operazione di upgrade è ancora in corso, non puoi monitorare i singoli passaggi di ogni upgrade.
Posso annullare l'upgrade dopo averlo avviato?
No, non puoi annullare un upgrade una volta avviato. Se l'upgrade non va a buon fine, Cloud SQL ripristina automaticamente l'istanza alla versione precedente.
Cosa succede alle mie impostazioni durante un upgrade?

Quando esegui un upgrade della versione principale in loco, Cloud SQL conserva le impostazioni del database, inclusi il nome dell'istanza, l'indirizzo IP, i valori dei flag configurati esplicitamente e i dati utente. Tuttavia, il valore predefinito delle variabili di sistema potrebbe cambiare.

Per scoprire di più, consulta Configura i flag di database. Se un determinato flag o valore non è più supportato nella versione di destinazione, Cloud SQL lo rimuove automaticamente durante l'upgrade.

Passaggi successivi