Esta página muestra cómo usar el método de actualización local para actualizar una instancia de Cloud SQL Enterprise Edition a Cloud SQL Enterprise Plus Edition. Además, describe el procedimiento para cambiar una instancia de Cloud SQL Enterprise Plus Edition a Cloud SQL Enterprise Edition.
Actualizar a la edición Cloud SQL Enterprise Plus le ofrece varias ventajas y mejoras de rendimiento. Para obtener más información, consulte Introducción a Cloud SQL para las ediciones de PostgreSQL .
Para habilitar estas mejoras en sus instancias de Cloud SQL Enterprise Edition, debe actualizarlas a Cloud SQL Enterprise Plus Edition. El proceso de actualización tarda unos minutos y prácticamente no tiene tiempo de inactividad. Cambiar a Cloud SQL Enterprise Edition puede tardar hasta 60 segundos.
Además, este proceso de actualización no requiere que cambies los puntos finales a los que se conectan tus aplicaciones.
Antes de empezar
Asegúrese de estar ejecutando una instancia de Cloud SQL Enterprise Edition en PostgreSQL 12 o posterior.
Si su instancia utiliza una versión anterior de PostgreSQL, debe actualizarla a PostgreSQL 12 o posterior. Para obtener más información, consulte Actualizar la versión principal de la base de datos localmente .
Verifique la ubicación de almacenamiento de los registros de transacciones utilizados para PITR
Todas las instancias de Cloud SQL Enterprise Plus se habilitan automáticamente con la recuperación a un punto en el tiempo (PITR). Si la instancia de Cloud SQL Enterprise que desea actualizar almacena en disco los registros de escritura anticipada utilizados para PITR, el proceso de actualización a Cloud SQL Enterprise Plus cambia la ubicación de almacenamiento de los registros de escritura anticipada del disco a Cloud Storage.
Antes de actualizar a la edición Cloud SQL Enterprise Plus, compruebe si su instancia de Cloud SQL Enterprise se someterá al cambio de ubicación de almacenamiento de los registros de escritura anticipada utilizados para PITR. Para obtener más información e instrucciones sobre cómo comprobar su instancia, consulte Comprobar la ubicación de almacenamiento de los registros de transacciones utilizados para PITR .
Para obtener más información sobre cómo cambiar la ubicación de almacenamiento del registro de transacciones durante el proceso de actualización, consulte Ubicación de almacenamiento de los registros de transacciones utilizados para PITR .
Actualizar una instancia a la edición Cloud SQL Enterprise Plus
Utilice el procedimiento de esta sección para actualizar una instancia de la edición Cloud SQL Enterprise a la edición Cloud SQL Enterprise Plus.
Consola
En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .
- Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
- Haga clic en Editar .
- En la sección Elegir una edición de Cloud SQL , haga clic en Actualizar .
- En el panel Actualizar a Enterprise Plus , ingrese su ID de instancia y luego haga clic en Actualizar edición .
Como alternativa, también puede actualizar una instancia haciendo clic en Actualizar en la sección Configuración de la página Descripción general de la instancia.
nube g
El siguiente ejemplo de código muestra cómo actualizar su instancia a la edición Cloud SQL Enterprise Plus:
gcloud sql instances patch INSTANCE_ID \ --edition=enterprise-plus \ --tier=MACHINE_TYPE \ --project=PROJECT_ID
Opcional: también puede habilitar el caché de datos para su instancia agregando el indicador --enable-data-cache
.
Reemplace lo siguiente:
- PROJECT_ID : el ID del proyecto de la instancia que desea actualizar.
- INSTANCE_ID : nombre de la instancia que desea actualizar.
- MACHINE_TYPE : el tipo de máquina de la instancia a la que desea actualizar. Para obtener más información sobre los tipos de máquina para la edición Cloud SQL Enterprise Plus, consulte Tipos de máquina para instancias de la edición Cloud SQL Enterprise Plus .
DESCANSAR
El siguiente comando actualiza su instancia a la edición Cloud SQL Enterprise y activa una operación de reinicio.
Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:
- PROJECT_ID : el ID del proyecto de la instancia que desea actualizar.
- INSTANCE_ID : el ID de instancia de la instancia que desea actualizar.
- MACHINE_TYPE : el tipo de máquina de la instancia a la que desea actualizar. Para obtener más información sobre los tipos de máquina para la edición Cloud SQL Enterprise Plus, consulte Tipos de máquina para instancias de la edición Cloud SQL Enterprise Plus .
Opcional: puede habilitar el caché de datos configurando el parámetro dataCacheEnabled
como true
.
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "tier": "MACHINE_TYPE", "edition": "ENTERPRISE_PLUS", "dataCacheConfig": { "dataCacheEnabled": true }, } }
Para enviar su solicitud, expanda una de estas opciones:
Debería recibir una respuesta JSON similar a la siguiente:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "[email protected]", "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
El siguiente comando actualiza su instancia a la edición Cloud SQL Enterprise y activa una operación de reinicio.
Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:
- PROJECT_ID : el ID del proyecto de la instancia que desea actualizar.
- INSTANCE_ID : el ID de instancia de la instancia que desea actualizar.
- MACHINE_TYPE : el tipo de máquina de la instancia a la que desea actualizar. Para obtener más información sobre los tipos de máquina para la edición Cloud SQL Enterprise Plus, consulte Tipos de máquina para instancias de la edición Cloud SQL Enterprise Plus .
Opcional: puede habilitar el caché de datos configurando el parámetro dataCacheEnabled
como true
.
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "tier": "MACHINE_TYPE", "edition": "ENTERPRISE_PLUS", "dataCacheConfig": { "dataCacheEnabled": true }, } }
Para enviar su solicitud, expanda una de estas opciones:
Debería recibir una respuesta JSON similar a la siguiente:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "[email protected]", "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" }
Ubicación de almacenamiento de los registros de transacciones utilizados para PITR
Si su instancia de la edición Cloud SQL Enterprise almacena registros de transacciones para PITR en el disco, al iniciar el proceso de actualización a la edición Cloud SQL Enterprise Plus, la ubicación de almacenamiento de estos registros cambia a Cloud Storage.
Las siguientes condiciones se aplican al proceso de cambio de ubicación:
- El proceso tarda aproximadamente la duración de la configuración PITR de
transactionLogRetentionDays
para completar el cambio a Cloud Storage. - Durante la migración a Cloud Storage, le recomendamos no modificar la configuración PITR de
transactionLogRetentionDays
. Incluso si aumentatransactionLogRetentionDays
, los registros de escritura anticipada no se conservarán en el disco más allá del tiempo predeterminado de 7 días para una instancia de Cloud SQL Enterprise Edition.
Valores predeterminados de almacenamiento de registros y copias de seguridad de la edición Cloud SQL Enterprise Plus
Tras completar la actualización a la edición Cloud SQL Enterprise Plus, el periodo de retención del registro de transacciones predeterminado para todas las instancias actualizadas aumenta a 14 días. Este aumento, así como cualquier otro que configure, requiere el nuevo valor para alcanzar el periodo de retención completo de PITR. Por ejemplo, si el valor anterior de días de retención del registro de transacciones era 7 y el nuevo valor aumenta a 14, el periodo de PITR durante los primeros 7 días posteriores a la actualización será de tan solo 7 días. El octavo día, el periodo de PITR se convierte en 8 días, el noveno en 9 días, y finalmente el decimocuarto día, el periodo de retención se amplía a 14 días.
Además, el número predeterminado de copias de seguridad automáticas aumenta de 8 a 15.
Si actualiza a la edición Cloud SQL Enterprise Plus después de una actualización de versión principal, no podrá realizar la restauración PITR a un momento anterior a dicha actualización. Esta limitación se aplica incluso si su período de retención cubre dicho período. Puede restaurar su instancia a un momento posterior a la actualización de versión principal.
Cambiar a la edición Cloud SQL Enterprise
Consola
En el Google Cloud consola, vaya a la página Instancias de Cloud SQL .
- Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.
- Haga clic en Editar .
- En la sección Elegir una edición de Cloud SQL , haga clic en Cambiar a Enterprise .
- En el panel Cambiar a Enterprise , ingrese su ID de instancia y luego haga clic en Cambiar edición .
Como alternativa, también puede cambiar a la edición Cloud SQL Enterprise haciendo clic en Cambiar a Enterprise en la sección Configuración de la página Descripción general de la instancia.
nube g
El siguiente ejemplo de código muestra cómo cambiar su instancia a la edición Cloud SQL Enterprise:
gcloud sql instances patch INSTANCE_ID \ --edition=enterprise \ --tier=MACHINE_TYPE \ --project=PROJECT_ID
- PROJECT_ID : el ID del proyecto de la instancia.
- INSTANCE_ID : nombre de la instancia.
- MACHINE_TYPE : el tipo de máquina de la instancia a la que desea cambiar. Para obtener más información sobre los tipos de máquina para Cloud SQL Enterprise Edition, consulte Tipos de máquina para instancias de Cloud SQL Enterprise Edition .
DESCANSAR
El siguiente comando cambia su instancia a la edición Cloud SQL Enterprise y activa una operación de reinicio.
Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:
- PROJECT_ID : el ID del proyecto de la instancia.
- INSTANCE_ID : el ID de instancia de la instancia.
- MACHINE_TYPE : el tipo de máquina de la instancia a la que desea cambiar. Para obtener más información sobre los tipos de máquina para Cloud SQL Enterprise Edition, consulte Tipos de máquina para instancias de Cloud SQL Enterprise Edition .
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "tier": "MACHINE_TYPE", "edition": "ENTERPRISE" } }
Para enviar su solicitud, expanda una de estas opciones:
Debería recibir una respuesta JSON similar a la siguiente:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "[email protected]", "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
El siguiente comando cambia su instancia a la edición Cloud SQL Enterprise y activa una operación de reinicio.
Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:
- PROJECT_ID : el ID del proyecto de la instancia.
- INSTANCE_ID : el ID de instancia de la instancia.
- MACHINE_TYPE : el tipo de máquina de la instancia a la que desea cambiar. Para obtener más información sobre los tipos de máquina para Cloud SQL Enterprise Edition, consulte Tipos de máquina para instancias de Cloud SQL Enterprise Edition .
Método HTTP y URL:
PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID
Cuerpo JSON de la solicitud:
{ "settings": { "tier": "MACHINE_TYPE", "edition": "ENTERPRISE" } }
Para enviar su solicitud, expanda una de estas opciones:
Debería recibir una respuesta JSON similar a la siguiente:
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID", "status": "PENDING", "user": "[email protected]", "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" }
Valores predeterminados de almacenamiento de registros y copias de seguridad de la edición Enterprise de Cloud SQL
Cambiar a la edición Cloud SQL Enterprise no modifica la ubicación de almacenamiento de los registros de transacciones utilizados para PITR. Si su instancia de Cloud SQL Enterprise Plus almacena sus registros de transacciones para PITR en Cloud Storage, estos permanecerán allí. Sin embargo, en lugar de almacenar 14 días de registros de transacciones para PITR de forma predeterminada, el valor predeterminado se cambia a 7 días. La configuración de la copia de seguridad no cambia.
Generar el punto final de escritura automáticamente
Un punto de conexión de escritura es un nombre de servicio de nombres de dominio (DNS) global que se resuelve automáticamente en la dirección IP de la instancia principal de Cloud SQL. Este punto de conexión redirige automáticamente las conexiones entrantes a la nueva instancia principal en caso de una conmutación por error de la réplica. Puede usar el punto de conexión de escritura en una cadena de conexión SQL en lugar de una dirección IP. Al usar un punto de conexión de escritura, puede evitar tener que realizar cambios en la conexión de la aplicación cuando se produce una interrupción regional.
Si actualiza su instancia que tiene una dirección IP privada en la nueva arquitectura de red a la edición Cloud SQL Enterprise Plus y habilita la API de DNS para suGoogle Cloud Si su proyecto está configurado en un proyecto de Azure Cloud SQL, este generará automáticamente el punto de conexión de escritura. Sin embargo, el certificado de servidor asociado a la instancia no tendrá el punto de conexión de escritura (nombre DNS global). Por lo tanto, si desea verificar el nombre DNS, debe rotar el certificado . Una vez rotado, Cloud SQL le agregará el nombre DNS. Puede usar el nombre DNS para la verificación de la identidad del servidor.
¿Qué sigue?
- Obtenga más información sobre la edición Cloud SQL Enterprise Plus .