Errores de actualización local de la versión principal de la base de datos

Para resolver las infracciones de la verificación previa a la actualización, las incompatibilidades de extensiones y los errores de límite de recursos cuando realizas una actualización de versión principal in situ en AlloyDB para PostgreSQL, aplica las correcciones recomendadas para los mensajes de error que devuelve tu operación de actualización. Para conocer los pasos generales de solución de problemas de actualización, consulta Soluciona problemas de una actualización de versión principal local.

Errores comunes de actualización de la versión principal

En las siguientes secciones, se describen los mensajes de error que pueden ocurrir durante una actualización de versión principal y cómo resolverlos.

Error: Base de datos: database_name. extension_violation: DEPRECATED, action_required: DELETE_EXTENSION

Descripción: AlloyDB detecta una extensión obsoleta. El error indica qué extensiones causaron un error:

database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION. Query format to delete the extensions: DROP EXTENSION {extension_name}; Violation list: [extensions]

Corrección recomendada: Borra la extensión. El formato de la consulta para borrar una extensión es DROP EXTENSION {extension_name};.

Error: Base de datos: database_name. extension_violation: INVALID_EXTENSION_VERSION, action_required: UPGRADE_EXTENSION

Descripción: AlloyDB detecta una versión de extensión no válida.

Corrección recomendada: Actualiza la extensión. El formato de la consulta para actualizar una extensión es ALTER EXTENSION {extension_name} UPDATE TO {target_version};.

Error: Base de datos: database_name contiene pg_largeobject

Descripción: AlloyDB detecta pg_largeobject.

Solución recomendada: Quita pg_largeobject antes de actualizar el clúster de AlloyDB.

ERROR: out of shared memory

Descripción: Si la instancia tiene memoria compartida insuficiente, es posible que veas este mensaje de error. Este error es más probable que suceda si tienes más de 10,000 tablas.

Solución recomendada: Antes de iniciar una actualización, establece el valor de la marca max_locks_per_transaction en aproximadamente el doble de la cantidad de tablas en la instancia. La instancia se reinicia cuando cambias el valor de esta marca.

ERROR: Conexiones insuficientes

Descripción: Si tu instancia no tiene capacidad de conexión suficiente, es posible que veas este mensaje de error.

Solución recomendada: Te recomendamos que aumentes el valor de la marca max_connections según la cantidad de bases de datos en tu instancia. Cuando cambias el valor de esta marca, se reinicia la instancia.

Las verificaciones previas a la actualización fallan

Descripción: Cuando actualizas tu clúster de AlloyDB, es posible que la actualización falle debido a las verificaciones previas a la actualización. Los detalles sobre los incumplimientos se encuentran en la respuesta de la API en forma de logs_url. Se te redireccionará a la página de la consola de Google Cloud en la que se encuentran los registros.

Corrección recomendada: Según el mensaje de error, consulta otros errores que se mencionan anteriormente en este documento para resolver el problema específico.

¿Qué sigue?