Pour résoudre les violations de vérification préalable à la mise à niveau, les incompatibilités d'extension et les erreurs de limite de ressources lorsque vous effectuez une mise à niveau de version majeure sur place dans AlloyDB pour PostgreSQL, appliquez les correctifs recommandés pour les messages d'erreur renvoyés par votre opération de mise à niveau. Pour connaître les étapes de dépannage générales, consultez Résoudre les problèmes liés à la mise à niveau d'une version majeure sur place.
Erreurs courantes de mise à niveau de version majeure
Les sections suivantes décrivent les messages d'erreur qui peuvent s'afficher lors d'une mise à niveau de version majeure et comment les résoudre.
Erreur : Base de données : database_name. extension_violation : DEPRECATED, action_required : DELETE_EXTENSION
Description : AlloyDB détecte une extension obsolète. L'erreur indique quelles extensions ont provoqué une erreur :
database_name. extension_violation: DEPRECATED_EXTENSION, action_required: DELETE_EXTENSION. Query format to delete the extensions: DROP EXTENSION {extension_name}; Violation list: [extensions]
Correction recommandée : supprimez l'extension. Le format de la requête pour supprimer une extension est DROP EXTENSION {extension_name};.
Erreur : Base de données : nom_base_de_données. extension_violation : INVALID_EXTENSION_VERSION, action_required : UPGRADE_EXTENSION
Description : AlloyDB détecte une version d'extension non valide.
Correction recommandée : mettez à niveau l'extension. Le format de la requête pour mettre à niveau une extension est ALTER EXTENSION {extension_name} UPDATE TO {target_version};.
Erreur : Base de données : database_name contient pg_largeobject
Description : AlloyDB détecte pg_largeobject.
Correction recommandée : supprimez pg_largeobject avant de mettre à niveau le cluster AlloyDB.
ERREUR : mémoire partagée insuffisante
Description : si l'instance dispose d'une mémoire partagée insuffisante, ce message d'erreur peut s'afficher. Cette erreur est plus susceptible de se produire si vous dépassez les 10 000 tables.
Correction recommandée : Avant de lancer une mise à niveau, définissez la valeur de l'option max_locks_per_transaction sur environ deux fois le nombre de tables présentes dans l'instance. L'instance est redémarrée lorsque vous modifiez la valeur de cette option.
ERREUR : Connexions insuffisantes
Description : Si la capacité de la connexion de votre instance est insuffisante, le message d'erreur suivant peut s'afficher.
Correction recommandée : nous vous recommandons d'augmenter la valeur de l'option max_connections en fonction du nombre de bases de données de votre instance. Lorsque vous modifiez la valeur de cette option, l'instance est redémarrée.
Échec des vérifications préalables à la mise à niveau
Description : Lorsque vous mettez à niveau votre cluster AlloyDB, la mise à niveau peut échouer en raison des vérifications préalables à la mise à niveau. Les détails des cas de non-conformité sont inclus dans la réponse de l'API sous la forme de logs_url. Vous êtes redirigé vers la page de la console Google Cloud où se trouvent les journaux.
Correction recommandée : En fonction du message d'erreur, consultez les autres erreurs listées précédemment dans ce document pour résoudre le problème spécifique.
Étapes suivantes
- Résoudre les problèmes liés à une mise à niveau de version majeure sur place
- Découvrez comment mettre à niveau la version majeure d'une base de données sur place.