Actualización in situ

En esta página, se describe cómo realizar actualizaciones y reversiones in situ de tus instancias de Cloud SQL.

Realiza cambios en una instancia de Cloud SQL

Puedes usar los cambios in situ para actualizar o cambiar a una versión anterior la edición, el tipo de máquina o el tipo de almacenamiento de tu instancia de Cloud SQL, o bien para actualizar su versión de base de datos. Realizar cambios in situ es la forma más fácil y menos propensa a errores de volver a configurar una instancia.

Antes de comenzar

Asegúrate de que tu instancia se ejecute en PostgreSQL 12 o versiones posteriores.

Si tu instancia está en una versión anterior de PostgreSQL, debes actualizarla 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.

Ten en cuenta los posibles cambios de almacenamiento relacionados con el tipo de máquina

Las diferentes ediciones admiten diferentes tipos de máquinas que usan distintas opciones de almacenamiento. Los tipos de máquinas C4 y C4A de alto rendimiento usan el almacenamiento Hyperdisk Balanced en lugar de una de las opciones de disco persistente que usan los tipos de máquinas más antiguos.

Cuando cambias la edición o el tipo de máquina que usas, es posible que también cambie el tipo de almacenamiento, lo que puede generar un tiempo de inactividad y un cambio en los costos de almacenamiento. Cuando te cambias a Google Cloud Hyperdisk Balanced, puedes especificar opciones de configuración adicionales. Para obtener más información, consulta Cambios en el almacenamiento.

Ten en cuenta los cambios en el almacenamiento de registros de transacciones de la PITR

Si actualizas una instancia de Cloud SQL Enterprise que almacena los registros de escritura anticipada que se usan para PITR en el disco, ten en cuenta que el proceso de actualización a la edición Cloud SQL Enterprise Plus mueve la ubicación de almacenamiento de esos registros del disco a Cloud Storage. Para determinar la ubicación actual de los registros de escritura anticipada de la PITR de tu instancia, consulta Verifica la ubicación de almacenamiento de los registros de transacciones que se usan para la PITR.

Para obtener una explicación completa de cómo las actualizaciones in situ pueden afectar la ubicación de los registros de escritura anticipada, consulta Cambios en la ubicación de almacenamiento de los registros de escritura anticipada para la PITR.

Cómo cambiar la edición de una instancia en el lugar

En esta sección, se muestra cómo cambiar la edición de tu instancia de Cloud SQL in situ a la edición Cloud SQL Enterprise Plus o desde ella. La edición Enterprise Plus de Cloud SQL ofrece algunos beneficios y mejoras de rendimiento que la edición Enterprise de Cloud SQL no ofrece. Para obtener más información sobre las ediciones de Cloud SQL, consulta la Descripción general de las ediciones de Cloud SQL.

La actualización a la edición Enterprise Plus de Cloud SQL tarda unos minutos en completarse y tiene un tiempo de inactividad casi nulo. Si vuelves a cambiar a la edición de Cloud SQL Enterprise, el tiempo de inactividad será más prolongado. Ninguno de los procesos requiere cambiar los extremos a los que se conectan tus aplicaciones.

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

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

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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"

$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

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

PATCH https://sqladmin.googleapis.com/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

{
  "settings": {
      "tier": "MACHINE_TYPE",
      "edition": "ENTERPRISE_PLUS",
      "dataCacheConfig": {
        "dataCacheEnabled": true
      },
  }
}

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"

$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

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

Opciones para cambios in situ

Cambiar la edición de tu instancia de Cloud SQL puede requerir que cambies su serie de máquinas, lo que, a su vez, afecta su tipo de almacenamiento.

Cambios en la máquina

Cuando cambias de edición, también debes cambiar el tipo de máquina. Consulta Elige una serie de máquinas para obtener más información sobre las series de máquinas que admite Cloud SQL.

Cuando actualizas de la edición Cloud SQL Enterprise a la edición Cloud SQL Enterprise Plus, puedes elegir entre las series de máquinas N2, C4A y C4.

Cuando cambias de la edición Cloud SQL Enterprise Plus a la edición Cloud SQL Enterprise, puedes elegir entre un núcleo dedicado de uso general y una serie de máquinas N4.

También puedes cambiar el tipo de máquina sin cambiar la edición. Después de elegir editar tu instancia, ve a la subsección Máquina de Configuración de máquina en el área Personaliza tu instancia. En el menú desplegable, puedes seleccionar otro tipo de máquina. También puedes elegir una cantidad diferente de CPUs virtuales y habilitar o inhabilitar la caché de datos, si es necesario.

Para obtener información más general, consulta también la documentación de Compute Engine para las series de máquinas N2, C4A, C4 y N4.

Cambios en el almacenamiento

Si cambias de una serie de máquinas de uso general o N2 a una serie de máquinas N4, C4A o C4, tu almacenamiento se migrará de unidad de disco de estado sólido (SSD) a almacenamiento Google Cloud Hyperdisk balanced. Por lo general, esta actualización requiere un tiempo de inactividad mínimo.

El almacenamiento de Hyperdisk Balanced de Google Cloud se puede personalizar para tu caso de uso con los siguientes parámetros de configuración:

• Capacidad de almacenamiento
• IOPS aprovisionadas
• Capacidad de procesamiento aprovisionada

Google Cloud Hyperdisk Balanced establece los valores predeterminados y los límites de IOPS y capacidad de procesamiento según la configuración de tu instancia, que incluye el tipo de máquina y la capacidad de almacenamiento. La capacidad de almacenamiento limita el valor predeterminado, y el tipo de máquina establece el valor máximo para las IOPS y la capacidad de procesamiento. Consulta Elige una opción de almacenamiento para obtener más detalles.

Cambios en la ubicación de los registros de escritura anticipada 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 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 el parámetro 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

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. No se modificó la configuración de la copia de seguridad.