Actualizar una instancia a la edición Enterprise Plus de Cloud SQL mediante una actualización in situ


En esta página se explica cómo usar el método de actualización in situ para actualizar una instancia de la edición Enterprise de Cloud SQL a la edición Enterprise Plus. Además, también se describe el procedimiento para cambiar una instancia de la edición Enterprise Plus de Cloud SQL a la edición Enterprise de Cloud SQL.

Al actualizar a la edición Cloud SQL Enterprise Plus, obtendrá varias ventajas y mejoras de rendimiento. Para obtener más información, consulta Introducción a las ediciones de Cloud SQL para PostgreSQL.

Para habilitar estas mejoras en tus instancias de la edición Enterprise de Cloud SQL, debes actualizarlas a la edición Enterprise Plus de Cloud SQL. El proceso de actualización tarda unos minutos en completarse y tiene un tiempo de inactividad casi nulo. Cambiar a la edición Enterprise de Cloud SQL puede provocar un tiempo de inactividad de hasta 60 segundos.

Además, este proceso de actualización no requiere que cambies los endpoints a los que se conectan tus aplicaciones.

Antes de empezar

  • Asegúrate de que estás usando una instancia de la edición Enterprise de Cloud SQL en PostgreSQL 12 o una versión posterior.

    Si tu instancia tiene una versión anterior de PostgreSQL, debes actualizarla a PostgreSQL 12 o una versión posterior. Para obtener más información, consulta Actualizar la versión principal de la base de datos in situ.

Comprobar la ubicación de almacenamiento de los registros de transacciones usados para PITR

Todas las instancias de la edición Enterprise Plus de Cloud SQL tienen habilitada automáticamente la recuperación a un momento dado (PITR). Si la instancia de la edición Enterprise de Cloud SQL que quieres actualizar almacena en disco los registros write-ahead que se usan para la recuperación a un momento dado, el proceso de actualización a la edición Enterprise Plus de Cloud SQL cambia la ubicación de almacenamiento de los registros write-ahead del disco a Cloud Storage.

Antes de actualizar a la edición Enterprise Plus de Cloud SQL, comprueba si tu instancia de la edición Enterprise de Cloud SQL va a cambiar la ubicación de almacenamiento de los registros write-ahead que se usan para la recuperación a un momento dado. Para obtener más información e instrucciones sobre cómo comprobar tu instancia, consulta Comprobar la ubicación de almacenamiento de los registros de transacciones usados para la restauración a un momento dado.

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, consulta Ubicación de almacenamiento de los registros de transacciones usados en la recuperación a un momento dado.

Actualizar una instancia a la edición Enterprise Plus de Cloud SQL

Sigue el procedimiento de esta sección para actualizar una instancia de la edición Enterprise de Cloud SQL a la edición Enterprise Plus.

Consola

  1. En la Google Cloud consola, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.
  3. Haz clic en Editar.
  4. En la sección Elige una edición de Cloud SQL, haz clic en Actualizar.
  5. En el panel Cambiar a Enterprise Plus, introduce el ID de tu instancia y haz clic en Cambiar de edición.

También puedes actualizar una instancia haciendo clic en Actualizar en la sección Configuración de la página Resumen de la instancia.

gcloud

En el siguiente código de ejemplo se muestra cómo actualizar tu instancia a la edición Enterprise Plus de Cloud SQL:

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

Opcional: también puedes habilitar la caché de datos de tu instancia añadiendo la marca --enable-data-cache.

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de la instancia que quieres actualizar.
  • INSTANCE_ID: nombre de la instancia que quieres actualizar.
  • MACHINE_TYPE: el tipo de máquina de la instancia a la que quieres actualizar. Para obtener más información sobre los tipos de máquinas de la edición Enterprise Plus de Cloud SQL, consulta Tipos de máquinas de las instancias de la edición Enterprise Plus de Cloud SQL.

REST

El siguiente comando actualiza tu instancia a la edición Enterprise de Cloud SQL y activa una operación de reinicio.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto de la instancia que quieres actualizar.
  • INSTANCE_ID: el ID de instancia de la instancia que quieres actualizar.
  • MACHINE_TYPE: el tipo de máquina de la instancia a la que quieres actualizar. Para obtener más información sobre los tipos de máquinas de la edición Enterprise Plus de Cloud SQL, consulta Tipos de máquinas de las instancias de la edición Enterprise Plus de Cloud SQL.

Opcional: puede habilitar la caché de datos definiendo 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 tu solicitud, despliega una de estas opciones:

Deberías 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": "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

El siguiente comando actualiza tu instancia a la edición Enterprise de Cloud SQL y activa una operación de reinicio.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

  • PROJECT_ID: el ID del proyecto de la instancia que quieres actualizar.
  • INSTANCE_ID: el ID de instancia de la instancia que quieres actualizar.
  • MACHINE_TYPE: el tipo de máquina de la instancia a la que quieres actualizar. Para obtener más información sobre los tipos de máquinas de la edición Enterprise Plus de Cloud SQL, consulta Tipos de máquinas de las instancias de la edición Enterprise Plus de Cloud SQL.

Opcional: puede habilitar la caché de datos definiendo 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 tu solicitud, despliega una de estas opciones:

Deberías 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": "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"
}

Ubicación de almacenamiento de los registros de transacciones que se usan para PITR

Si tu instancia de la edición Enterprise de Cloud SQL almacena registros de transacciones para PITR en el disco, al iniciar el proceso de actualización a la edición Enterprise Plus de Cloud SQL, la ubicación de almacenamiento de estos registros cambiará a Cloud Storage.

El proceso de cambio de ubicación está sujeto a las siguientes condiciones:

  • El proceso tarda aproximadamente lo que dure el ajuste de configuración transactionLogRetentionDays PITR en completar el cambio a Cloud Storage.
  • Durante el cambio a Cloud Storage, te recomendamos que no modifiques el ajuste de configuración transactionLogRetentionDays PITR. Aunque aumentes transactionLogRetentionDays, los registros write-ahead no se conservarán en el disco más de 7 días, que es el valor predeterminado para una instancia de Cloud SQL Enterprise Edition.

Valores predeterminados de almacenamiento de copias de seguridad y registros de la edición Cloud SQL Enterprise Plus

Una vez que se haya completado la actualización a la edición Cloud SQL Enterprise Plus, el periodo de conservación predeterminado de los registros de transacciones de todas las instancias actualizadas se ampliará a 14 días. Para que se aplique este aumento y cualquier otro que configure para el periodo de conservación de los registros de transacciones, se necesita un tiempo equivalente al nuevo valor aumentado para alcanzar el periodo de conservación completo de la restauración a un momento dado. Por ejemplo, si el valor antiguo de los días de conservación de los registros de transacciones es 7 y el nuevo valor se aumenta a 14, el periodo de PITR durante los primeros 7 días después de la actualización será de 7 días. El octavo día, el periodo de PITR será de 8 días; el noveno día, de 9 días, y así sucesivamente hasta que el periodo de conservación aumente a 14 días el día 14.

Además, el número predeterminado de copias de seguridad automatizadas se ha aumentado de 8 a 15.

Si actualizas a la edición Enterprise Plus de Cloud SQL después de hacer una actualización de versión principal, no podrás realizar una recuperación a un momento dado anterior a la actualización de versión principal. Esta limitación se aplica aunque el periodo de conservación incluya ese periodo. Puedes restaurar tu instancia a un momento dado después de iniciar la actualización de la versión principal.

Cambiar a la edición Enterprise de Cloud SQL

Consola

  1. En la Google Cloud consola, ve a la página Instancias de Cloud SQL.

    Ir a Instancias de Cloud SQL

  2. Para abrir la página Overview (Resumen) de una instancia, haz clic en su nombre.
  3. Haz clic en Editar.
  4. En la sección Elige una edición de Cloud SQL, haz clic en Cambiar a Enterprise.
  5. En el panel Cambiar a Enterprise, introduce el ID de tu instancia y haz clic en Cambiar de edición.

También puedes cambiar a la edición Enterprise de Cloud SQL haciendo clic en Cambiar a Enterprise en la sección Configuración de la página Información general de la instancia.

gcloud

En el siguiente ejemplo de código se muestra cómo cambiar tu instancia a la edición Enterprise de Cloud SQL:

gcloud sql instances patch INSTANCE_ID \
  --edition=enterprise \
  --tier=MACHINE_TYPE \
  --project=PROJECT_ID
 Sustituye lo siguiente:

REST

El siguiente comando cambia tu instancia a la edición Enterprise de Cloud SQL y activa una operación de reinicio.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

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 tu solicitud, despliega una de estas opciones:

Deberías 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": "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

El siguiente comando cambia tu instancia a la edición Enterprise de Cloud SQL y activa una operación de reinicio.

Antes de usar los datos de la solicitud, haz las siguientes sustituciones:

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 tu solicitud, despliega una de estas opciones:

Deberías 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": "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"
}

Valores predeterminados de almacenamiento de copias de seguridad y registros de la edición Enterprise de Cloud SQL

Si cambias a la edición Enterprise de Cloud SQL, no se modificará la ubicación de almacenamiento de los registros de transacciones que se usan para la recuperación a un momento dado. Si tu instancia de la edición Enterprise Plus de Cloud SQL almacena sus registros de transacciones para PITR en Cloud Storage, los registros permanecerán en Cloud Storage. Sin embargo, en lugar de almacenar 14 días de registros de transacciones para PITR de forma predeterminada, el valor predeterminado se ha cambiado a 7 días. La configuración de la copia de seguridad no cambia.

Generar el endpoint de escritura automáticamente

Un endpoint 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 actual. Este endpoint redirige automáticamente las conexiones entrantes a la nueva instancia principal en caso de que se produzca una conmutación por error de la réplica. Puede usar el endpoint de escritura en una cadena de conexión SQL en lugar de una dirección IP. Si usas un endpoint de escritura, no tendrás que hacer cambios en la conexión de la aplicación cuando se produzca una interrupción en una región.

Si actualizas a la edición Enterprise Plus de Cloud SQL una instancia que tiene una dirección IP privada en la nueva arquitectura de red y habilitas la API DNS en tu proyectoGoogle Cloud , Cloud SQL generará automáticamente el endpoint de escritura. Sin embargo, el certificado de servidor asociado a la instancia no tendrá añadido el endpoint de escritura (nombre DNS global). Por lo tanto, si quieres verificar el nombre de DNS, debes rotar el certificado. Una vez que se haya completado la rotación de este certificado, Cloud SQL añadirá el nombre DNS al certificado. Puedes usar el nombre de DNS para verificar la identidad del servidor.

Siguientes pasos