Questa pagina mostra come utilizzare il metodo di upgrade in loco per eseguire l'upgrade di un'istanza Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus. Inoltre, descrive anche la procedura per passare da un'istanza Cloud SQL Enterprise Plus a Cloud SQL Enterprise.
L'upgrade alla versione Cloud SQL Enterprise Plus offre diversi vantaggi e miglioramenti delle prestazioni. Per saperne di più, consulta la sezione 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 ha un tempo di inattività quasi nullo. Il passaggio alla versione Cloud SQL Enterprise può richiedere fino a 60 secondi di inattività.
Inoltre, questa procedura di upgrade non richiede di modificare gli endpoint a cui si connettono le tue applicazioni.
Prima di iniziare
Assicurati di eseguire un'istanza Cloud SQL Enterprise 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, vedi Eseguire l'upgrade in loco della versione principale del database.
Controlla la posizione di archiviazione dei log delle transazioni utilizzati per il PITR
Tutte le istanze Cloud SQL Enterprise Plus sono abilitate automaticamente con il recupero point-in-time (PITR). Se l'istanza di Cloud SQL Enterprise di cui vuoi eseguire l'upgrade archivia i log write-ahead utilizzati per il PITR su disco, la procedura di upgrade a Cloud SQL Enterprise Plus sposta la posizione di archiviazione dei log write-ahead dal disco a Cloud Storage.
Prima di eseguire l'upgrade alla versione Cloud SQL Enterprise Plus, controlla se l'istanza Cloud SQL Enterprise subirà il cambio di posizione di archiviazione per i log write-ahead utilizzati per il PITR. Per ulteriori informazioni e istruzioni su come controllare l'istanza, vedi Controllare la posizione di archiviazione dei log delle transazioni utilizzati per il recupero point-in-time.
Per ulteriori informazioni sul cambio della posizione di archiviazione del log delle transazioni durante la procedura di upgrade, vedi Posizione di archiviazione dei log delle transazioni utilizzati per il PITR.
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 Cloud SQL Enterprise alla versione Cloud SQL Enterprise Plus.
Console
-
Nella console Google Cloud , vai alla pagina 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 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
(Facoltativo) Puoi anche attivare la cache dei dati per la tua istanza aggiungendo il flag --enable-data-cache.
Sostituisci quanto segue:
- PROJECT_ID: l'ID progetto dell'istanza che vuoi eseguire l'upgrade.
- INSTANCE_ID: il nome dell'istanza che 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 di Cloud SQL Enterprise Plus, consulta Tipi di macchine per le istanze di Cloud SQL Enterprise Plus.
REST
Il comando seguente esegue l'upgrade dell'istanza a 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 che vuoi eseguire l'upgrade.
- INSTANCE_ID: l'ID istanza dell'istanza che 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 di Cloud SQL Enterprise Plus, consulta Tipi di macchine per le istanze di 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:
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 a 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 che vuoi eseguire l'upgrade.
- INSTANCE_ID: l'ID istanza dell'istanza che 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 di Cloud SQL Enterprise Plus, consulta Tipi di macchine per le istanze di 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:
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"
}
Posizione di archiviazione dei log delle transazioni utilizzati per il PITR
Se la tua istanza Cloud SQL Enterprise Edition archivia i log delle transazioni per il PITR su disco, l'avvio della procedura di upgrade a Cloud SQL Enterprise Plus Edition cambia la posizione di archiviazione di questi log in Cloud Storage.
Al processo di cambio di località si applicano le seguenti condizioni:
- Il processo richiede all'incirca la durata dell'impostazione di configurazione
transactionLogRetentionDaysPITR 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 aumentitransactionLogRetentionDays, i log write-ahead non verranno conservati sul disco più a lungo del valore predefinito di 7 giorni per un'istanza Cloud SQL Enterprise.
Valori predefiniti di archiviazione dei log e dei backup di Cloud SQL Enterprise Plus
Al termine dell'upgrade alla versione Cloud SQL Enterprise Plus, il periodo di conservazione predefinito del log delle transazioni per tutte le istanze sottoposte ad upgrade viene aumentato a 14 giorni. Per questo aumento e per qualsiasi altro aumento che configuri per il periodo di conservazione dei log delle transazioni, è necessario un periodo di tempo pari al 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 il PITR per i primi 7 giorni dopo l'upgrade è di soli 7 giorni. L'ottavo giorno, la finestra per il PITR diventa di 8 giorni, il nono giorno diventa di 9 giorni, fino a quando la finestra di conservazione non viene aumentata a 14 giorni il quattordicesimo giorno.
Inoltre, il numero predefinito di backup automatici viene 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 (PITR) a un momento precedente all'upgrade della versione principale. Questa limitazione si applica anche se il periodo di conservazione copre quel periodo di tempo. Puoi ripristinare l'istanza a un punto temporale dopo aver avviato l'upgrade della versione principale.
Passare alla versione Cloud SQL Enterprise
Console
-
Nella console Google Cloud , vai alla pagina 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 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
- 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 Cloud SQL Enterprise, consulta Tipi di macchine per le istanze di Cloud SQL Enterprise.
REST
Il seguente comando cambia l'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.
- INSTANCE_ID: l'ID istanza dell'istanza.
- MACHINE_TYPE: il tipo di macchina dell'istanza a cui vuoi passare. Per saperne di più sui tipi di macchine per Cloud SQL Enterprise, consulta Tipi di macchine per le istanze di 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:
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 cambia l'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.
- INSTANCE_ID: l'ID istanza dell'istanza.
- MACHINE_TYPE: il tipo di macchina dell'istanza a cui vuoi passare. Per saperne di più sui tipi di macchine per Cloud SQL Enterprise, consulta Tipi di macchine per le istanze di 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:
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"
}
Valori predefiniti di archiviazione di backup e log di Cloud SQL Enterprise
Il passaggio a Cloud SQL Enterprise Edition non cambia la posizione di archiviazione dei log delle transazioni utilizzati per il PITR. Se l'istanza Cloud SQL Enterprise Plus memorizza i log delle transazioni per il PITR in Cloud Storage, i log rimangono in Cloud Storage. Tuttavia, anziché archiviare 14 giorni di log delle transazioni per PITR per impostazione predefinita, il valore predefinito è stato modificato a 7 giorni. La configurazione del backup non viene modificata.
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 primaria corrente. Questo endpoint reindirizza automaticamente le connessioni in entrata 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é un indirizzo IP. Utilizzando un endpoint di scrittura, puoi evitare di dover apportare modifiche alla connessione dell'applicazione quando si verifica un'interruzione 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 abiliti l'API DNS per il tuo progettoGoogle Cloud , Cloud SQL genera automaticamente l'endpoint di scrittura. Tuttavia, il certificato del server associato all'istanza non avrà 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.