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 SQL Server.

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. 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 SQL Server Enterprise 2019 o SQL Server Enterprise 2022.

Nota: Si configuras la marca max server memory (mb), te sugerimos que la quites después de actualizar tu instancia a la edición Cloud SQL Enterprise Plus. De esta manera, Cloud SQL puede administrar el valor de la marca de forma automática. Sin embargo, si prefieres configurar el valor, puedes volver a revisar el valor de la marca después de actualizar la instancia y ajustar el valor según el tamaño de la VM.

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

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:

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.

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.