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


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

La actualización a la edición Enterprise Plus de Cloud SQL te proporciona varios beneficios y mejoras de rendimiento. Si deseas obtener más información, consulta Introducción a las ediciones de Cloud SQL para MySQL.

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

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

Antes de comenzar

Verifica la ubicación de almacenamiento de los registros de transacciones que se usan para la PITR

Todas las instancias de Cloud SQL Enterprise Plus se habilitan de forma automática con la recuperación de un momento determinado (PITR). Si la instancia de Cloud SQL Enterprise de la que deseas actualizar almacena los registros binarios que se usan para PITR en el disco, el proceso de actualización a Cloud SQL Enterprise Plus cambia la ubicación de almacenamiento de los registros binarios de la edición de Cloud SQL Enterprise Plus. el disco a Cloud Storage.

Antes de actualizar a la edición Cloud SQL Enterprise Plus, verifica si tu instancia de Cloud SQL Enterprise se someterá al cambio de ubicación de almacenamiento para los registros binarios que se usan en PITR. Para obtener más información y las instrucciones para verificar tu instancia, consulta Verifica la ubicación de almacenamiento de los registros de transacciones que se usan para la PITR.

Si necesitas más información para cambiar la ubicación de almacenamiento de los registros de transacciones en el proceso de actualización, consulta Ubicación de almacenamiento de los registros de transacciones que se usan para la PITR.

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

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

para tu instancia de forma predeterminada durante el proceso de actualización.

Console

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

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general 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 Actualizar a Enterprise Plus, ingresa el ID de tu instancia y, luego, haz clic en Actualizar edición.

Como alternativa, también puedes actualizar una instancia si haces clic en Actualizar en la sección Configuración de la página Descripción general de la instancia.

gcloud

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

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

Reemplaza lo siguiente:

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

REST

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

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, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 Cloud SQL Enterprise Edition y activa una operación de reinicio.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

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, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 del almacenamiento de los registros de transacciones que se usan para la PITR

Si tu instancia de Cloud SQL Enterprise almacena registros de transacciones para PITR en el disco, cuando se inicia el proceso de actualización a la edición Cloud SQL Enterprise Plus, se cambia la ubicación de almacenamiento de estos registros 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 de la PITR transactionLogRetentionDays para completar el cambio a Cloud Storage.
  • Si tienes valores establecidos para la marca expire_logs_days o binlog_expire_logs_seconds en tu instancia, esos valores se conservan.
  • Durante el cambio a Cloud Storage, no puedes modificar los valores para las marcas expire_logs_days o binlog_expire_logs_seconds en la instancia.
  • Durante el cambio a Cloud Storage, te recomendamos que no modifiques los parámetros de configuración de la PITR transactionLogRetentionDays. Incluso si aumentas transactionLogRetentionDays, los registros binarios no se conservarán en el disco más tiempo que el valor predeterminado de 7 días para una instancia de Cloud SQL Enterprise.
  • Mientras el cambio está en curso, Cloud SQL solo conserva los registros en el disco para el valor mínimo de una de las siguientes opciones:
    • el parámetro de configuración de la PITR transactionLogRetentionDays anterior al cambio, de forma predeterminada en 7 días
    • las marcas expire_logs_days o binlog_expire_logs_seconds establecidas de forma manual en tu instancia
  • Después del cambio, Cloud SQL retiene la misma cantidad de registros binarios en el disco que tenías antes del cambio, a menos que hubieras configurado las marcas expire_logs_days o binlog_expire_logs_seconds en tu instancia. Si configuraste estas marcas, Cloud SQL retiene registros binarios en el disco según el valor mínimo de la configuración transactionLogRetentionDays o el valor de las marcas.

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

Una vez que se completa el cambio a Cloud Storage de una instancia, Cloud SQL aún retiene copias de los registros binarios en el disco para fines de replicación. Almacenar registros binarios en un disco puede ser útil si quieres explorar registros binarios con la utilidad mysqlbinlog.

Si configuraste las marcas expire_logs_days y binlog_expire_logs_seconds en tu instancia antes de la actualización, los valores configurados permanecerán intactos.

Después del cambio, ya que los registros binarios que se usan para realizar la PITR ahora se almacenan en Cloud Storage, asegúrate de que los valores de las marcas reflejen la retención de los registros de transacciones en el disco que esperas. Cloud SQL solo retiene registros en el disco para el valor mínimo de uno de los siguientes:

  • la configuración de la PITR transactionLogRetentionDays antes del cambio, 7 días de forma predeterminada
  • las marcas expire_logs_days o binlog_expire_logs_seconds establecidas de forma manual en tu instancia

Si deseas ahorrar espacio en el disco, después de que se complete la actualización, configura el valor de la marca expire_logs_days o binlog_expire_logs_seconds en el equivalente a 1 día para poder reducir el tamaño de disco asignado y costos de almacenamiento en disco. Para más información sobre el almacenamiento de registros de transacciones y la PITR, Consulta Almacenamiento de registros para la PITR.

Una vez que se completa la actualización a la edición Cloud SQL Enterprise Plus, el período predeterminado de retención de registros de transacciones para todas las instancias actualizadas aumenta a 14 días. Para este aumento y cualquier otro aumento que configures para el período de retención de los registros de transacciones, demora hasta el mayor valor nuevo en alcanzar el período de retención completo de la PITR. Por ejemplo, si el valor anterior para los días de retención de registros de transacciones es 7 y el valor nuevo se incrementa a 14, el período para la PITR durante los primeros 7 días después de la actualización es de solo 7 días. El octavo día, el período para la PITR es de 8 días, el noveno día es de 9 días, hasta que el período de retención finalmente aumenta a 14 días el día 14.

Además, la cantidad predeterminada de copias de seguridad automáticas aumenta de 8 a 15.

Si actualizas a la edición Enterprise Plus de Cloud SQL después de realizar una actualización de versión principal, no podrás realizar la PITR en un momento determinado que ocurra antes de la actualización de la versión principal. Esta limitación se aplica incluso si tu período de retención abarca ese período. Puedes restablecer la instancia a un momento determinado después de iniciar la actualización de la versión principal.

Cambia a Cloud SQL Enterprise Edition

Console

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

    Ir a Instancias de Cloud SQL

  2. Para abrir la página de Descripción general 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, ingresa tu ID de instancia y, luego, haz clic en Cambiar edición.

De manera alternativa, también puedes cambiar a la edición Cloud SQL Enterprise si haces clic en Switch to Enterprise en la sección Configuration de la página Overview de la instancia.

gcloud

En la siguiente muestra de código, se enseña 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
 Reemplaza lo siguiente:
  • PROJECT_ID: el ID del proyecto de la instancia.
  • INSTANCE_ID: el nombre de la instancia.
  • MACHINE_TYPE: el tipo de máquina de la instancia a la que deseas cambiar. Para obtener más información sobre los tipos de máquina de Cloud SQL edición Enterprise, consulta Tipos de máquinas para instancias de Cloud SQL Enterprise.

REST

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

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

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, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 Cloud SQL Enterprise Edition y activa una operación de reinicio.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

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

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, expande una de estas opciones:

Deberías recibir una respuesta JSON similar a la que se muestra a continuación:

{
  "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 registros y copia de seguridad de Cloud SQL Enterprise

Cambiar a la edición Enterprise de Cloud SQL no cambia la ubicación de almacenamiento de los registros de transacciones que se usan para la PITR. Si tu instancia de edición de Cloud SQL Enterprise Plus almacena sus registros de transacciones para la PITR en Cloud Storage, los registros permanecen en Cloud Storage. Sin embargo, en lugar de almacenar 14 días de registros de transacciones para la PITR de forma predeterminada, el valor predeterminado se cambia a 7 días. La configuración de la copia de seguridad no se modifica.

¿Qué sigue?