Actualizar la versión principal de la base de datos en el lugar

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Esta página describe cómo actualizar la versión principal de la base de datos actualizando su instancia de Cloud SQL en el lugar en lugar de migrar los datos .

Introducción

Los proveedores de software de bases de datos lanzan periódicamente nuevas versiones principales con nuevas funciones, mejoras de rendimiento y de seguridad. Cloud SQL acepta nuevas versiones tras su lanzamiento. Una vez que Cloud SQL ofrece soporte para una nueva versión principal, puede actualizar sus instancias para mantener su base de datos actualizada.

Puede actualizar la versión de la base de datos de una instancia localmente o migrando datos . Las actualizaciones locales son una forma más sencilla de actualizar la versión principal de su instancia. No necesita migrar datos ni cambiar las cadenas de conexión de la aplicación. Con las actualizaciones locales, puede conservar el nombre, la dirección IP y otras configuraciones de su instancia actual después de la actualización. Las actualizaciones locales no requieren mover archivos de datos y se completan más rápido. En algunos casos, el tiempo de inactividad es menor que el que implica migrar los datos.

Planificar una actualización de versión importante

1. Confirme que tiene el rol necesario para realizar una actualización de versión principal: Propietario de Cloud SQL o Administrador de Cloud SQL .

2. Elija una versión principal de destino.

   nube g

   Para obtener información sobre la instalación y los primeros pasos con la CLI de gcloud, consulte Instalar la CLI de gcloud . Para obtener información sobre cómo iniciar Cloud Shell, consulte Usar Cloud Shell .

   Para comprobar las versiones de base de datos que puede seleccionar para una actualización local en su instancia, haga lo siguiente:

   1. Ejecute el siguiente comando.

   gcloud sql instances describe INSTANCE_NAME
      

   Reemplace INSTANCE_NAME con el nombre de la instancia.

   2. En la salida del comando, ubique la sección denominada upgradableDatabaseVersions .
   3. Cada subsección devuelve una versión de la base de datos que puede actualizarse. En cada subsección, revise los siguientes campos.
   • majorVersion : la versión principal a la que puede apuntar para la actualización local.
   • name : la cadena de versión de la base de datos que incluye la versión principal.
   • displayName : el nombre para mostrar de la versión de la base de datos.

   REST versión 1

   Para verificar qué versiones de la base de datos de destino están disponibles para una actualización local de una versión principal, utilice el método instances.get de la API de administración de Cloud SQL.

   Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

   • INSTANCE_NAME : El nombre de la instancia.

   Método HTTP y URL:

   GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

   Para enviar su solicitud, expanda una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Ejecute el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Ejecute el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Debería recibir una respuesta JSON similar a la siguiente:

   
   upgradableDatabaseVersions:
   
   {
     major_version: "SQLSERVER_2022_STANDARD"
     name: "SQLSERVER_2022_STANDARD"
     display_name: "SQL Server 2022 Standard"
   }
   
   

   REST v1beta4

   Para verificar qué versiones de la base de datos de destino están disponibles para la actualización local de la versión principal de una instancia, utilice el método instances.get de la API de administración de Cloud SQL.

   Antes de utilizar cualquiera de los datos solicitados, realice las siguientes sustituciones:

   • INSTANCE_NAME : El nombre de la instancia.

   Método HTTP y URL:

   GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

   Para enviar su solicitud, expanda una de estas opciones:

   curl (Linux, macOS o Cloud Shell)

   Ejecute el siguiente comando:

   curl -X GET \
        -H "Authorization: Bearer $(gcloud auth print-access-token)" \
        "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

   PowerShell (Windows)

   Ejecute el siguiente comando:

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
       -Method GET `
       -Headers $headers `
       -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

   Debería recibir una respuesta JSON similar a la siguiente:

   
   upgradableDatabaseVersions:
   
   {
     major_version: "SQLSERVER_2022_STANDARD"
     name: "SQLSERVER_2022_STANDARD"
     display_name: "SQL Server 2022 Standard"
   }
   
   

   Para obtener la lista completa de las versiones de bases de datos compatibles con Cloud SQL, consulte Versiones de bases de datos y políticas de versiones .

3. Tenga en cuenta las características ofrecidas en cada versión principal de la base de datos y aborde las incompatibilidades.

   Consulte las características discontinuadas y los cambios importantes de SQL Server.

   Las nuevas versiones principales introducen cambios incompatibles que podrían requerir la modificación del código de la aplicación, el esquema o la configuración de la base de datos. Antes de actualizar la instancia de la base de datos, revise las notas de la versión principal de destino para determinar las incompatibilidades que debe solucionar.

4. Pruebe la actualización con una ejecución en seco.

   Realice un simulacro del proceso de actualización integral en un entorno de prueba antes de actualizar la base de datos de producción. Puede clonar su instancia para crear una copia idéntica de los datos con la que probar el proceso de actualización.

   Además de validar que la actualización se complete exitosamente, ejecute pruebas para garantizar que la aplicación se comporte como se espera en la base de datos actualizada.

5. Decide un momento para realizar la actualización.

   La actualización requiere que la instancia no esté disponible durante un tiempo. Planifique la actualización durante un período de baja actividad de la base de datos.

Realizar la actualización de la versión principal

Puede actualizar la versión principal de una sola instancia de Cloud SQL o puede actualizar la versión principal de una instancia principal e incluir todas sus réplicas en la actualización, incluidas las réplicas en cascada y las réplicas entre regiones.

Actualizar la versión principal de una sola instancia

Cuando inicia una operación de actualización para una sola instancia, Cloud SQL hace lo siguiente:

1. Comprueba la configuración de su instancia para garantizar que la instancia sea compatible para una actualización.
2. Después de que Cloud SQL verifica la configuración, hace que la instancia no esté disponible.
3. Realiza una copia de seguridad previa a la actualización.
4. Realiza la actualización en la instancia.
5. Hace que su instancia esté disponible.
6. Realiza una copia de seguridad posterior a la actualización.

resource "google_sql_database_instance" "instance" {
  name             = "sqlserver-instance"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

Al solicitar una actualización local, Cloud SQL realiza primero una comprobación previa. Si Cloud SQL determina que su instancia no está lista para una actualización, la solicitud fallará y mostrará un mensaje que sugiere cómo solucionar el problema. Consulte también Solucionar problemas de una actualización de versión principal .

Copias de seguridad de actualización automáticas

Cuando realiza una actualización de versión importante, Cloud SQL realiza automáticamente dos copias de seguridad a pedido, denominadas copias de seguridad de actualización:

• La primera copia de seguridad de la actualización es la copia de seguridad previa a la actualización, que se realiza justo antes de iniciarla. Puede usar esta copia de seguridad para restaurar la instancia de la base de datos a su estado original.
• La segunda copia de seguridad de actualización es la copia de seguridad posterior a la actualización , que se realiza inmediatamente después de que se permiten nuevas escrituras en la instancia de base de datos actualizada.

Al consultar la lista de copias de seguridad , las de actualización se muestran como " On-demand . Estas copias de seguridad están etiquetadas para que pueda identificarlas rápidamente. Por ejemplo, si actualiza de SQL Server Enterprise 2017 a SQL Server Enterprise 2019 o SQL Server Enterprise 2022, la copia de seguridad previa a la actualización se etiqueta como Pre-upgrade backup, SQLSERVER_2017_ENTERPRISE to SQLSERVER_2019_ENTERPRISE or SQLSERVER_2022_ENTERPRISE. Y la copia de seguridad posterior a la actualización se etiqueta como Post-upgrade backup, SQLSERVER_2019_ENTERPRISE or SQLSERVER_2022_ENTERPRISE from SQLSERVER_2017_ENTERPRISE.

Al igual que con otras copias de seguridad a pedido, las copias de seguridad de actualización persisten hasta que las elimine o elimine la instancia.

Actualizar el nivel de compatibilidad de la base de datos

El nivel de compatibilidad de la base de datos determina su comportamiento con respecto a la aplicación a la que sirve. Esta configuración garantiza la compatibilidad con versiones anteriores de SQL Server y está relacionada con los cambios en Transact-SQL y el Optimizador de consultas. Al actualizar la versión de la base de datos de una instancia de SQL Server, se conservan los niveles de compatibilidad de las bases de datos existentes, de modo que la aplicación pueda seguir funcionando en la versión más reciente de SQL Server. Actualizar el nivel de compatibilidad le permite beneficiarse de nuevas funciones, mejoras en el procesamiento de consultas y otros cambios.

Tras actualizar la versión del motor de base de datos de una instancia, cuando la aplicación a la que sirve la base de datos esté lista, actualice el nivel de compatibilidad de cada base de datos de la instancia. Al establecer el nivel de compatibilidad al más reciente, las bases de datos se actualizan con las últimas funciones y un rendimiento mejorado.

Para actualizar el nivel de compatibilidad de la base de datos, realice los siguientes pasos:

1. Identifique el nivel de compatibilidad actual de su base de datos.

   Por ejemplo, para SQL Server 2017, el nivel de compatibilidad predeterminado es 140. Para comprobar el nivel de compatibilidad actual de su base de datos, ejecute el siguiente comando en Transact-SQL, después de reemplazar DATABASE_NAME

   con el nombre de la base de datos en su instancia de SQL Server.

   USE DATABASE_NAME
   GO
   SELECT compatibility_level
   FROM sys.databases WHERE name = 'DATABASE_NAME'

2. Determinar el nivel de compatibilidad objetivo.

   Identifique la designación del nivel de compatibilidad predeterminado para la versión actualizada de su base de datos para determinar el nivel de compatibilidad objetivo. Por ejemplo, para SQL Server 2022, el nivel de compatibilidad predeterminado es 160. Consulte la tabla que asigna nuevas versiones de SQL Server a los niveles de compatibilidad .

3. Evalúa las diferencias entre tus niveles de compatibilidad actuales y tus objetivos.

   Antes de actualizar el nivel de compatibilidad, analice las diferencias en el comportamiento del sistema entre su nivel de compatibilidad actual y el nivel de compatibilidad objetivo. Consulte la lista completa de diferencias entre los niveles de compatibilidad .

4. Recopile una línea base de datos de carga de trabajo.

   Antes de actualizar el nivel de compatibilidad, recopile una línea base de datos de carga de trabajo mediante el Almacén de consultas de SQL Server para poder identificar y abordar posteriormente las consultas regresivas. El Almacén de consultas se utiliza para capturar consultas y planes de un ciclo comercial típico y establecer una línea base de rendimiento. Para un flujo de trabajo guiado, utilice el Asistente para el ajuste de consultas de SQL Server Management Studio.

5. Mejora el nivel de compatibilidad.

   Para cambiar el nivel de compatibilidad de la base de datos, ejecute el siguiente comando en Transact-SQL, después de reemplazar DATABASE_NAME

   con el nombre de la base de datos en su instancia de SQL Server y TARGET_COMPATIBILITY_LEVEL con el nivel de compatibilidad de destino.

   ALTER DATABASE DATABASE_NAME
   SET COMPATIBILITY_LEVEL = TARGET_COMPATIBILITY_LEVEL;
   GO

6. Recopilar datos de carga de trabajo actualizados.

   Recopile datos de carga de trabajo actualizados mediante Query Store para realizar comparaciones y detectar regresiones.

7. Abordar consultas regresivas.

   En general, los cambios del Optimizador de Consultas en los niveles de compatibilidad actualizados mejoran el rendimiento. Sin embargo, ocasionalmente, el rendimiento de algunas consultas puede disminuir. La función Consultas Regresadas del Almacén de Consultas ayuda a identificar las consultas que han sufrido una regresión y permite forzar el último plan de consulta válido conocido. SQL Server también ofrece la corrección automática de planes , que puede cambiar automáticamente al último plan válido conocido en caso de una regresión de consultas.

Completar la actualización de la versión principal

Después de actualizar la instancia principal, realice pruebas de aceptación para asegurarse de que el sistema actualizado funcione como se espera.

Solucionar problemas de una actualización de versión importante

Cloud SQL devuelve un mensaje de error si intenta un comando de actualización no válido, por ejemplo, si su instancia contiene indicadores de base de datos no válidos para la nueva versión.

Si su solicitud de actualización falla, verifique su sintaxis. Si la solicitud tiene una estructura válida, consulte las siguientes sugerencias.

Ver registros de actualización

Si ocurre algún problema con una solicitud de actualización válida, Cloud SQL publica registros de errores en projects/ PROJECT_ID /logs/cloudsql.googleapis.com%2Fsqlserver.err . Cada entrada del registro contiene una etiqueta con el identificador de la instancia para ayudarle a identificar la instancia con el error de actualización. Busque estos errores de actualización y resuélvalos.

Para ver los registros de errores, siga estos pasos:

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

   Ir a Instancias de Cloud SQL

2. Para abrir la página Descripción general de una instancia, haga clic en el nombre de la instancia.

3. En el panel Operaciones y registros de la página Descripción general de la instancia, haga clic en el vínculo Ver registros de errores de SQL Server .

   Se abre la página del Explorador de registros .

4. Ver registros de la siguiente manera:

   • Para enumerar todos los registros de errores de un proyecto, seleccione el nombre del registro en el filtro de registro Nombre del registro .

   Para obtener más información sobre los filtros de consulta, consulte Consultas avanzadas .

   • Para filtrar los registros de errores de actualización de una sola instancia, ingrese la siguiente consulta en el cuadro Buscar en todos los campos , después de reemplazar DATABASE_ID

   con el ID del proyecto seguido del nombre de la instancia en este formato: project_id:instance_name .

   resource.type="cloudsql_database"
   resource.labels.database_id="DATABASE_ID"
   logName : "projects/PROJECT_ID/logs/cloudsql.googleapis.com%2Fsqlserver.err"

   Por ejemplo, para filtrar los registros de errores de actualización por una instancia llamada shopping-db que se ejecuta en el proyecto buylots , utilice el siguiente filtro de consulta:

    resource.type="cloudsql_database"
    resource.labels.database_id="buylots:shopping-db"
    logName : "projects/buylots/logs/cloudsql.googleapis.com%2Fsqlserver.err"

Restaurar la instancia principal a la versión principal anterior

Si su sistema de base de datos actualizado no funciona como se esperaba, es posible que deba restaurar la instancia principal a la versión anterior. Para ello, restaure la copia de seguridad previa a la actualización a una instancia de recuperación de Cloud SQL, que es una instancia nueva que ejecuta la versión anterior a la actualización.

Para restaurar una instancia principal a la versión anterior, realice los siguientes pasos:

1. Identifique su copia de seguridad previa a la actualización.

   Consulte Copias de seguridad de actualización automática .

2. Crear una instancia de recuperación.

   Cree una nueva instancia de Cloud SQL con la versión principal que Cloud SQL estaba ejecutando al realizar la copia de seguridad previa a la actualización. Configure los mismos indicadores y la misma configuración de instancia que la instancia original.

3. Restaure su copia de seguridad previa a la actualización.

   Restaure la copia de seguridad previa a la actualización en la instancia de recuperación. Esto podría tardar varios minutos.

4. Añade tus réplicas de lectura.

   Si está utilizando réplicas de lectura, agréguelas individualmente.

5. Conecte su aplicación.

   Tras recuperar su sistema de base de datos, actualice su aplicación con los detalles de la instancia de recuperación y sus réplicas de lectura. Puede reanudar el servicio de tráfico en la versión anterior a la actualización de su base de datos.

Limitaciones

Esta sección enumera las limitaciones para una actualización de versión principal local.

• No es posible realizar una actualización de versión principal local en una réplica externa .

Preguntas frecuentes

Las siguientes preguntas pueden surgir al actualizar la versión principal de la base de datos.

¿Mi instancia no está disponible durante una actualización?

Sí. Su instancia permanecerá no disponible durante un período de tiempo mientras Cloud SQL realiza la actualización.

¿Cuánto tiempo tarda una actualización?

Actualizar una sola instancia suele tardar menos de 10 minutos. Si la configuración de su instancia tiene pocas vCPU o memoria, la actualización podría tardar más.

Si su instancia aloja demasiadas bases de datos o tablas, o si sus bases de datos son muy grandes, la actualización podría tardar horas o incluso agotar el tiempo de espera, ya que el tiempo total de actualización corresponde a la cantidad de objetos en sus bases de datos. Si tiene varias instancias que necesitan actualizarse, el tiempo de actualización aumenta proporcionalmente.

¿Puedo supervisar cada paso de mi proceso de actualización?

Si bien Cloud SQL le permite monitorear si una operación de actualización aún está en progreso, no puede rastrear los pasos individuales en cada actualización.

¿Puedo cancelar mi actualización después de haberla iniciado?

No, no se puede cancelar una actualización una vez iniciada. Si la actualización falla, Cloud SQL recupera automáticamente la instancia a la versión anterior.

¿Qué sucede con mi configuración durante una actualización?

Al realizar una actualización local de una versión principal, Cloud SQL conserva la configuración de la base de datos, incluyendo el nombre de la instancia, la dirección IP, los valores de los indicadores configurados explícitamente y los datos de usuario. Sin embargo, el valor predeterminado de las variables del sistema podría cambiar.

Para obtener más información, consulte Configurar indicadores de base de datos . Si un indicador o valor determinado ya no es compatible con la versión de destino, Cloud SQL lo elimina automáticamente durante la actualización.

¿Qué sigue?

• Obtenga información sobre las opciones para conectarse a una instancia .
• Obtenga información sobre la importación y exportación de datos .
• Obtenga más información sobre cómo configurar los indicadores de la base de datos .