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 toma unos minutos en completarse con un tiempo de inactividad esperado de menos de 60 segundos. Además, este proceso no requiere que tus aplicaciones cambien los extremos a los que se conectan.

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.

Asegúrate de que tu instancia use una unidad de estado sólido (SSD).

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"
}

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"
}

¿Qué sigue?

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