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

MySQL | PostgreSQL | SQL Server

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 PostgreSQL.

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

Asegúrate de ejecutar una instancia de Cloud SQL Enterprise Edition en PostgreSQL 12 o versiones posteriores.

Si tu instancia está en una versión anterior de PostgreSQL, debes actualizar la instancia a PostgreSQL 12 o una versión posterior. Para obtener más información, consulta Actualiza la versión principal de la base de datos de manera local.

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 de escritura anticipada 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 de escritura anticipada desde 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 de escritura anticipada 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.

Console

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

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
Haz clic en Editar.
En la sección Elige una edición de Cloud SQL, haz clic en Actualizar.
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

Opcional: También puedes habilitar la caché de datos para la instancia si agregas la marca --enable-data-cache.

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.

Opcional: puedes habilitar la caché de datos si estableces 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a la CLI de gcloud con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login, o a través del uso de Cloud Shell, que accede de forma automática a la CLI de gcloud. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a la CLI de gcloud con tu cuenta de usuario mediante la ejecución de gcloud init o gcloud auth login. Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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.

Opcional: puedes habilitar la caché de datos si estableces 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, expande una de estas opciones:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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.

Se aplican las siguientes condiciones 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.
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 de escritura anticipada 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.

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

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

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

Ir a Instancias de Cloud SQL
Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
Haz clic en Editar.
En la sección Elige una edición de Cloud SQL, haz clic en Cambiar a Enterprise.
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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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:

curl (Linux, macOS o Cloud Shell)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID"

PowerShell (Windows)

Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID" | Select-Object -Expand Content

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?

Obtén más información sobre la edición Cloud SQL Enterprise Plus.