Résoudre les problèmes liés à une mise à niveau de version majeure sur place

Pour diagnostiquer et résoudre les problèmes qui surviennent lors d'une mise à niveau de version majeure sur place de votre cluster AlloyDB pour PostgreSQL, identifiez l'étape de mise à niveau ayant échoué dans la réponse de l'opération et corrigez les violations des vérifications préalables à la mise à niveau. Pour obtenir des instructions détaillées sur la mise à niveau, consultez Mettre à niveau la version majeure d'une base de données sur place. Pour obtenir des messages d'erreur spécifiques et des solutions, consultez Erreurs de mise à niveau de la version majeure de la base de données sur place.

AlloyDB valide votre requête de manière synchrone et renvoie un message d'erreur si l'une des conditions suivantes est remplie :

  • La requête n'est pas valide. Par exemple, si la version majeure cible fournie n'est pas compatible, ou si elle est inférieure ou égale à la version majeure actuelle.
  • Les ressources du cluster sont dans un état qui ne permet pas de déclencher la mise à niveau de la version majeure. Par exemple, si le cluster ou l'une des instances associées ne sont pas à l'état READY.

Si la requête est valide, la mise à niveau peut échouer pour les raisons suivantes :

  • Les vérifications préalables à la mise à niveau effectuées à différentes étapes peuvent échouer, ce qui indique que des cas de non-conformité ont été détectés. Vous devez corriger ces cas de non-respect avant de relancer la mise à niveau.
  • Les erreurs internes signifient que vous devez relancer la mise à niveau. Si les nouvelles tentatives échouent, contactez Cloud Customer Care.

Échecs de la vérification préalable à la mise à niveau d'AlloyDB

Les échecs de la vérification préalable à la mise à niveau peuvent se produire à l'une des étapes suivantes :

  • Vérifications préalables à la mise à niveau d'AlloyDB (ALLOYDB_PRECHECK)
  • pg_upgrade vérification (PG_UPGRADE_CHECK)
  • Mises à niveau du cluster principal (PRIMARY_INSTANCE_UPGRADE)

Les échecs de la vérification préalable à la mise à niveau sont des problèmes détectés par AlloyDB lors de la phase de validation préalable à la mise à niveau, qui peuvent entraîner l'échec de la mise à niveau sur place de la version majeure. Par exemple, AlloyDB vérifie les incompatibilités d'extension entre la version majeure actuelle et la version majeure cible.

Les messages d'erreur sont renseignés dans le champ logs_url de la réponse de l'opération de mise à niveau. Vous pouvez afficher ces journaux en accédant à l'explorateur de journaux dans la console Google Cloud . Pour en savoir plus, consultez Afficher les journaux de mise à niveau.

Pour afficher les échecs et les messages d'erreur correspondants que vous pouvez voir dans les journaux, consultez Erreurs de mise à niveau de la version majeure de la base de données sur place.

Voici un exemple de résumé généré dans les journaux par les vérifications préalables à la mise à niveau d'AlloyDB :

Total number of databases checked for custom checks: 3
Total number of databases containing pg_largeobject: 0
Total number of databases containing event triggers permissions issue: 0
Total number of databases containing extensions compatibility violation: 1
Total number of databases containing search path violations: 0

Échecs de la vérification pg_upgrade

PG_UPGRADE_CHECK recherche les cas de non-respect à l'aide de l'utilitaire pg_upgrade standard. Cette vérification de la mise à niveau inclut les incohérences de données résultant de divers facteurs, y compris les différences au niveau des structures de données spécifiques à la version, des modifications de l'encodage et du classement, des modifications des types de données et des ajustements du catalogue système.

Plusieurs fichiers, tels que tables_with_oids.txt et tables_using_reg.txt, qui sont générés lors de pg_upgrade, sont exportés vers le fichier journal postgres_upgrade. Vous pouvez filtrer ces fichiers à l'aide de l'étiquette labels.FILE_NAME.

Les noms de fichiers susceptibles de contenir des erreurs sont les suivants :

Nom de fichier Description

tables_with_oids.txt

Ce fichier contient des tables répertoriées avec des identifiants d'objet (OID). Supprimez les tables ou modifiez-les pour qu'elles n'utilisent pas d'OID.

tables_using_composite.txt

Ce fichier contient des tables répertoriées à l'aide de types composites définis par le système. Supprimez les tables ou modifiez-les pour qu'elles n'utilisent pas ces types composites.

tables_using_unknown.txt

Ce fichier contient des tables répertoriées à l'aide du type de données UNKNOWN. Supprimez les tables ou modifiez-les pour qu'elles n'utilisent pas ce type de données.

tables_using_sql_identifier.txt

Ce fichier contient des tables répertoriées à l'aide du type de données SQL_IDENTIFIER. Supprimez les tables ou modifiez-les pour qu'elles n'utilisent pas ce type de données.

tables_using_reg.txt

Ce fichier contient des tables répertoriées à l'aide du type de données REG* (par exemple, REGCOLLATION ou REGNAMESPACE). Supprimez les tables ou modifiez-les pour qu'elles n'utilisent pas ce type de données.

postfix_ops.txt

Ce fichier contient des tables répertoriées à l'aide d'opérateurs postfix (unaire à droite). Supprimez les tables ou modifiez-les pour qu'elles n'utilisent pas ces opérateurs.

Échecs de pg_upgrade

La structure des journaux PG_UPGRADE est semblable à celle des journaux PG_UPGRADE_CHECK.

Voici un exemple de journal avec l'étiquette labels.FILE_NAME=pg_upgrade_dump*.log: :

pg_upgrade_dump: error: query failed: ERROR: out of shared memory
HINT: You might need to increase max_locks_per_transaction.

Étapes suivantes